IMAP MCP Server
by LinaMorgan
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Port for npm run web (imap-setup uses --port). | 3000 |
| IMAP_MCP_BIND | No | Address the setup wizard binds to (--host takes precedence). The wizard listens on 127.0.0.1 only by default. | 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 setup wizard is bound beyond loopback (at least 16 characters); by default a random token is generated per start. It is then not printed. | |
| 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 at runtime. Keyed by the account name, uppercased with every non-alphanumeric character replaced by _ (e.g. 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 at runtime. 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; overrides apply only to existing accounts. | |
| IMAP_MCP_ACCOUNT_<NAME>_SMTP_PASSWORD | No | Overrides the SMTP password of an already-configured account at runtime. Keyed by the account name, uppercased with every non-alphanumeric character replaced by _. Takes effect only when the account already has an SMTP config. | |
| IMAP_MCP_ACCOUNT_<NAME>_SMTP_USERNAME | No | Overrides the SMTP username (smtp.user) of an already-configured account at runtime. Keyed by the account name, uppercased with every non-alphanumeric character replaced by _. Takes effect only when the account already has an SMTP config. |
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
ResponsivenessNo issues