MCP Server

Email (IMAP/SMTP) MCP Server

Name: Email (IMAP/SMTP) MCP Server
Author: io.github.mindstone

io.github.mindstone/mcp-server-email-imap

Repository Registry

What is the Email (IMAP/SMTP) MCP server?

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

How to install Email (IMAP/SMTP)

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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_ALLOW_PLAINTEXT
Set to 1 to opt into cleartext IMAP/SMTP (strongly discouraged)
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)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-email-imap": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-email-imap"
      ],
      "env": {
        "EMAIL_IMAP_EMAIL": "<YOUR_EMAIL_IMAP_EMAIL>",
        "EMAIL_IMAP_PASSWORD": "<YOUR_EMAIL_IMAP_PASSWORD>",
        "EMAIL_IMAP_PROVIDER": "<YOUR_EMAIL_IMAP_PROVIDER>",
        "EMAIL_IMAP_IMAP_HOST": "<YOUR_EMAIL_IMAP_IMAP_HOST>",
        "EMAIL_IMAP_SMTP_HOST": "<YOUR_EMAIL_IMAP_SMTP_HOST>",
        "EMAIL_IMAP_IMAP_PORT": "<YOUR_EMAIL_IMAP_IMAP_PORT>",
        "EMAIL_IMAP_SMTP_PORT": "<YOUR_EMAIL_IMAP_SMTP_PORT>",
        "EMAIL_IMAP_ALLOW_PLAINTEXT": "<YOUR_EMAIL_IMAP_ALLOW_PLAINTEXT>",
        "EMAIL_IMAP_MAX_RECIPIENTS": "<YOUR_EMAIL_IMAP_MAX_RECIPIENTS>",
        "EMAIL_IMAP_RATE_LIMIT_PER_HOUR": "<YOUR_EMAIL_IMAP_RATE_LIMIT_PER_HOUR>",
        "EMAIL_IMAP_RATE_LIMIT_WINDOW_MS": "<YOUR_EMAIL_IMAP_RATE_LIMIT_WINDOW_MS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-email-imap": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-email-imap"
      ],
      "env": {
        "EMAIL_IMAP_EMAIL": "<YOUR_EMAIL_IMAP_EMAIL>",
        "EMAIL_IMAP_PASSWORD": "<YOUR_EMAIL_IMAP_PASSWORD>",
        "EMAIL_IMAP_PROVIDER": "<YOUR_EMAIL_IMAP_PROVIDER>",
        "EMAIL_IMAP_IMAP_HOST": "<YOUR_EMAIL_IMAP_IMAP_HOST>",
        "EMAIL_IMAP_SMTP_HOST": "<YOUR_EMAIL_IMAP_SMTP_HOST>",
        "EMAIL_IMAP_IMAP_PORT": "<YOUR_EMAIL_IMAP_IMAP_PORT>",
        "EMAIL_IMAP_SMTP_PORT": "<YOUR_EMAIL_IMAP_SMTP_PORT>",
        "EMAIL_IMAP_ALLOW_PLAINTEXT": "<YOUR_EMAIL_IMAP_ALLOW_PLAINTEXT>",
        "EMAIL_IMAP_MAX_RECIPIENTS": "<YOUR_EMAIL_IMAP_MAX_RECIPIENTS>",
        "EMAIL_IMAP_RATE_LIMIT_PER_HOUR": "<YOUR_EMAIL_IMAP_RATE_LIMIT_PER_HOUR>",
        "EMAIL_IMAP_RATE_LIMIT_WINDOW_MS": "<YOUR_EMAIL_IMAP_RATE_LIMIT_WINDOW_MS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-email-imap": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-email-imap"
      ],
      "env": {
        "EMAIL_IMAP_EMAIL": "<YOUR_EMAIL_IMAP_EMAIL>",
        "EMAIL_IMAP_PASSWORD": "<YOUR_EMAIL_IMAP_PASSWORD>",
        "EMAIL_IMAP_PROVIDER": "<YOUR_EMAIL_IMAP_PROVIDER>",
        "EMAIL_IMAP_IMAP_HOST": "<YOUR_EMAIL_IMAP_IMAP_HOST>",
        "EMAIL_IMAP_SMTP_HOST": "<YOUR_EMAIL_IMAP_SMTP_HOST>",
        "EMAIL_IMAP_IMAP_PORT": "<YOUR_EMAIL_IMAP_IMAP_PORT>",
        "EMAIL_IMAP_SMTP_PORT": "<YOUR_EMAIL_IMAP_SMTP_PORT>",
        "EMAIL_IMAP_ALLOW_PLAINTEXT": "<YOUR_EMAIL_IMAP_ALLOW_PLAINTEXT>",
        "EMAIL_IMAP_MAX_RECIPIENTS": "<YOUR_EMAIL_IMAP_MAX_RECIPIENTS>",
        "EMAIL_IMAP_RATE_LIMIT_PER_HOUR": "<YOUR_EMAIL_IMAP_RATE_LIMIT_PER_HOUR>",
        "EMAIL_IMAP_RATE_LIMIT_WINDOW_MS": "<YOUR_EMAIL_IMAP_RATE_LIMIT_WINDOW_MS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-server-email-imap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-email-imap"
      ],
      "env": {
        "EMAIL_IMAP_EMAIL": "<YOUR_EMAIL_IMAP_EMAIL>",
        "EMAIL_IMAP_PASSWORD": "<YOUR_EMAIL_IMAP_PASSWORD>",
        "EMAIL_IMAP_PROVIDER": "<YOUR_EMAIL_IMAP_PROVIDER>",
        "EMAIL_IMAP_IMAP_HOST": "<YOUR_EMAIL_IMAP_IMAP_HOST>",
        "EMAIL_IMAP_SMTP_HOST": "<YOUR_EMAIL_IMAP_SMTP_HOST>",
        "EMAIL_IMAP_IMAP_PORT": "<YOUR_EMAIL_IMAP_IMAP_PORT>",
        "EMAIL_IMAP_SMTP_PORT": "<YOUR_EMAIL_IMAP_SMTP_PORT>",
        "EMAIL_IMAP_ALLOW_PLAINTEXT": "<YOUR_EMAIL_IMAP_ALLOW_PLAINTEXT>",
        "EMAIL_IMAP_MAX_RECIPIENTS": "<YOUR_EMAIL_IMAP_MAX_RECIPIENTS>",
        "EMAIL_IMAP_RATE_LIMIT_PER_HOUR": "<YOUR_EMAIL_IMAP_RATE_LIMIT_PER_HOUR>",
        "EMAIL_IMAP_RATE_LIMIT_WINDOW_MS": "<YOUR_EMAIL_IMAP_RATE_LIMIT_WINDOW_MS>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-server-email-imap --env EMAIL_IMAP_EMAIL=<YOUR_EMAIL_IMAP_EMAIL> --env EMAIL_IMAP_PASSWORD=<YOUR_EMAIL_IMAP_PASSWORD> --env EMAIL_IMAP_PROVIDER=<YOUR_EMAIL_IMAP_PROVIDER> --env EMAIL_IMAP_IMAP_HOST=<YOUR_EMAIL_IMAP_IMAP_HOST> --env EMAIL_IMAP_SMTP_HOST=<YOUR_EMAIL_IMAP_SMTP_HOST> --env EMAIL_IMAP_IMAP_PORT=<YOUR_EMAIL_IMAP_IMAP_PORT> --env EMAIL_IMAP_SMTP_PORT=<YOUR_EMAIL_IMAP_SMTP_PORT> --env EMAIL_IMAP_ALLOW_PLAINTEXT=<YOUR_EMAIL_IMAP_ALLOW_PLAINTEXT> --env EMAIL_IMAP_MAX_RECIPIENTS=<YOUR_EMAIL_IMAP_MAX_RECIPIENTS> --env EMAIL_IMAP_RATE_LIMIT_PER_HOUR=<YOUR_EMAIL_IMAP_RATE_LIMIT_PER_HOUR> --env EMAIL_IMAP_RATE_LIMIT_WINDOW_MS=<YOUR_EMAIL_IMAP_RATE_LIMIT_WINDOW_MS> -- npx -y @mindstone/mcp-server-email-imap