English Français العربية

Email (IMAP/SMTP)

Official registry Productivity

Email IMAP/SMTP MCP server: iCloud, Gmail, Yahoo, Outlook, and custom IMAP providers

Source code

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @mindstone/mcp-server-email-imap
Claude Code 
claude mcp add email-imap-smtp -e 'EMAIL_IMAP_EMAIL=<EMAIL_IMAP_EMAIL>' -e 'EMAIL_IMAP_PASSWORD=<your email_imap_password>' -e 'EMAIL_IMAP_PROVIDER=<EMAIL_IMAP_PROVIDER>' -e 'EMAIL_IMAP_IMAP_HOST=<EMAIL_IMAP_IMAP_HOST>' -e 'EMAIL_IMAP_SMTP_HOST=<EMAIL_IMAP_SMTP_HOST>' -e 'EMAIL_IMAP_IMAP_PORT=993' -e 'EMAIL_IMAP_SMTP_PORT=587' -e 'EMAIL_IMAP_MAX_RECIPIENTS=25' -e 'EMAIL_IMAP_RATE_LIMIT_PER_HOUR=50' -e 'EMAIL_IMAP_RATE_LIMIT_WINDOW_MS=3600000' -e 'MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH>' -- npx -y @mindstone/mcp-server-email-imap@0.3.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "email-imap-smtp": {
            "command": "npx",
            "args": [
                "-y",
                "@mindstone/mcp-server-email-imap@0.3.2"
            ],
            "env": {
                "EMAIL_IMAP_EMAIL": "<EMAIL_IMAP_EMAIL>",
                "EMAIL_IMAP_PASSWORD": "<your email_imap_password>",
                "EMAIL_IMAP_PROVIDER": "<EMAIL_IMAP_PROVIDER>",
                "EMAIL_IMAP_IMAP_HOST": "<EMAIL_IMAP_IMAP_HOST>",
                "EMAIL_IMAP_SMTP_HOST": "<EMAIL_IMAP_SMTP_HOST>",
                "EMAIL_IMAP_IMAP_PORT": "993",
                "EMAIL_IMAP_SMTP_PORT": "587",
                "EMAIL_IMAP_MAX_RECIPIENTS": "25",
                "EMAIL_IMAP_RATE_LIMIT_PER_HOUR": "50",
                "EMAIL_IMAP_RATE_LIMIT_WINDOW_MS": "3600000",
                "MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>"
            }
        }
    }
}

Environment variables

  • EMAIL_IMAP_EMAIL required Email address
  • EMAIL_IMAP_PASSWORD required secret App-specific password
  • EMAIL_IMAP_PROVIDER Provider — icloud, gmail, yahoo, outlook, or custom (auto-detected from email domain if unset)
  • EMAIL_IMAP_IMAP_HOST Custom IMAP host (for provider=custom)
  • EMAIL_IMAP_SMTP_HOST Custom SMTP host (for provider=custom)
  • EMAIL_IMAP_IMAP_PORT Custom IMAP port
  • EMAIL_IMAP_SMTP_PORT Custom SMTP port
  • EMAIL_IMAP_MAX_RECIPIENTS Safety cap: maximum combined To+CC+BCC recipients per email_send call. Defaults to 25; raising bypasses spam-prevention guardrails against prompt-injection-driven mass sends.
  • EMAIL_IMAP_RATE_LIMIT_PER_HOUR Safety cap: maximum email_send calls per rolling window. Defaults to 50; protects against runaway sends when injection content escapes the LLM's intent.
  • EMAIL_IMAP_RATE_LIMIT_WINDOW_MS Sliding-window length for the rate limit (ms)
  • MCP_WORKSPACE_PATH Workspace directory that email_get_attachment downloads into (fresh email-imap-attachment-* staging directories). Defaults to the system temp directory.

Frequently asked questions

What is Email (IMAP/SMTP)?

Email IMAP/SMTP MCP server: iCloud, Gmail, Yahoo, Outlook, and custom IMAP providers

How do I install Email (IMAP/SMTP)?

It runs on your machine. In Claude Code: claude mcp add email-imap-smtp -e 'EMAIL_IMAP_EMAIL=<EMAIL_IMAP_EMAIL>' -e 'EMAIL_IMAP_PASSWORD=<your email_imap_password>' -e 'EMAIL_IMAP_PROVIDER=<EMAIL_IMAP_PROVIDER>' -e 'EMAIL_IMAP_IMAP_HOST=<EMAIL_IMAP_IMAP_HOST>' -e 'EMAIL_IMAP_SMTP_HOST=<EMAIL_IMAP_SMTP_HOST>' -e 'EMAIL_IMAP_IMAP_PORT=993' -e 'EMAIL_IMAP_SMTP_PORT=587' -e 'EMAIL_IMAP_MAX_RECIPIENTS=25' -e 'EMAIL_IMAP_RATE_LIMIT_PER_HOUR=50' -e 'EMAIL_IMAP_RATE_LIMIT_WINDOW_MS=3600000' -e 'MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH>' -- npx -y @mindstone/mcp-server-email-imap@0.3.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Email (IMAP/SMTP) need an API key?

Yes. It expects EMAIL_IMAP_EMAIL, EMAIL_IMAP_PASSWORD, which you set in its configuration.

Is Email (IMAP/SMTP) open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Email (IMAP/SMTP)?

It is published by mindstone. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.