imap-mcp-server
by bachdaniels
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Port for `npm run web` (the setup wizard uses --port instead). Default: 3000. | 3000 |
| IMAP_MCP_BIND | No | Address the setup wizard binds to. Default: 127.0.0.1. The --host flag takes precedence. | 127.0.0.1 |
| IMAP_MCP_READ_ONLY | No | When truthy (1, true, yes, on), only the safe, read-only tools are registered — searching, reading, listing folders, unread counts, spam analysis. No tool that sends mail, deletes/moves messages, changes flags, or edits accounts is exposed. | |
| IMAP_MCP_WIZARD_TOKEN | No | Access token used when the wizard is bound beyond loopback. If unset, a random token is generated per start and printed. Must be at least 16 characters. | |
| IMAP_MCP_ENABLED_TOOLS | No | Comma-separated allowlist of tool names — only these are registered. Names are case-insensitive and the imap_ prefix is optional (search_emails ≡ imap_search_emails). When set, it takes precedence over IMAP_MCP_READ_ONLY. | |
| IMAP_MCP_ACCOUNT_<NAME>_IMAP_PASSWORD | No | Overrides the IMAP password of an already-configured account. Keyed by the account name, uppercased with every non-alphanumeric character replaced by _ (e.g. account "Work Gmail" → IMAP_MCP_ACCOUNT_WORK_GMAIL_IMAP_PASSWORD). Applied in memory only, consumed at startup. | |
| IMAP_MCP_ACCOUNT_<NAME>_IMAP_USERNAME | No | Overrides the IMAP username (user) of an already-configured account. The variable is keyed by the account name, uppercased with every non-alphanumeric character replaced by _ (e.g. account "Work Gmail" → IMAP_MCP_ACCOUNT_WORK_GMAIL_IMAP_USERNAME). Applied in memory only, consumed at startup. | |
| IMAP_MCP_ACCOUNT_<NAME>_SMTP_PASSWORD | No | Overrides the SMTP password of an already-configured account. Takes effect only when the account already has an SMTP config. Keyed by the account name, uppercased with every non-alphanumeric character replaced by _ (e.g. account "Work Gmail" → IMAP_MCP_ACCOUNT_WORK_GMAIL_SMTP_PASSWORD). Applied in memory only, consumed at startup. | |
| IMAP_MCP_ACCOUNT_<NAME>_SMTP_USERNAME | No | Overrides the SMTP username (smtp.user) of an already-configured account. Takes effect only when the account already has an SMTP config. Keyed by the account name, uppercased with every non-alphanumeric character replaced by _ (e.g. account "Work Gmail" → IMAP_MCP_ACCOUNT_WORK_GMAIL_SMTP_USERNAME). Applied in memory only, consumed at startup. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessResponsive