IMAP MCP Server
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`). Default: `3000`. | |
| IMAP_MCP_BIND | No | Address the setup wizard binds to (`--host` takes precedence). 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 | Fixed access token for the setup wizard when bound beyond loopback (at least 16 characters); otherwise a random token is generated per start and 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, where `<NAME>` is 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 at runtime, where `<NAME>` is 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 at runtime, where `<NAME>` is 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. 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, where `<NAME>` is 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. 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