Email (IMAP/SMTP) MCP Server

by mindstoneio.github.mindstone/mcp-server-email-imapv0.3.2

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

12Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active10d ago

Install Email (IMAP/SMTP) MCP server

claude mcp add email-imap -e EMAIL_IMAP_EMAIL='<email-imap-email>' -e EMAIL_IMAP_PASSWORD='<email-imap-password>' -- npx -y @mindstone/mcp-server-email-imap

{
  "mcpServers": {
    "email-imap": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-email-imap"
      ],
      "env": {
        "EMAIL_IMAP_EMAIL": "<email-imap-email>",
        "EMAIL_IMAP_PASSWORD": "<email-imap-password>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "email-imap": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-email-imap"
      ],
      "env": {
        "EMAIL_IMAP_EMAIL": "<email-imap-email>",
        "EMAIL_IMAP_PASSWORD": "<email-imap-password>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "email-imap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-email-imap"
      ],
      "env": {
        "EMAIL_IMAP_EMAIL": "<email-imap-email>",
        "EMAIL_IMAP_PASSWORD": "<email-imap-password>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "email-imap": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-email-imap"
      ],
      "env": {
        "EMAIL_IMAP_EMAIL": "<email-imap-email>",
        "EMAIL_IMAP_PASSWORD": "<email-imap-password>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
EMAIL_IMAP_EMAIL	yes	—	Email address
EMAIL_IMAP_PASSWORD	yes	yes	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.

Freshness

Active — last maintenance signal 10d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-29 · 10d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-10 · 2mo ago · official registry · v0.3.2

FAQ

›How do I install the Email (IMAP/SMTP) MCP server in Claude Code?

Run: claude mcp add email-imap -e EMAIL_IMAP_EMAIL='<email-imap-email>' -e EMAIL_IMAP_PASSWORD='<email-imap-password>' -- npx -y @mindstone/mcp-server-email-imap. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Email (IMAP/SMTP) require an API key?

Yes. It expects EMAIL_IMAP_EMAIL, EMAIL_IMAP_PASSWORD, of which 1 is a secret.

›Can I use Email (IMAP/SMTP) as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Email (IMAP/SMTP) in the official MCP registry?

Yes, as io.github.mindstone/mcp-server-email-imap.