MCP Server MCP

Email (IMAP/SMTP)

By github 👁 1 views ▲ 0 votes

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

Homepage Verified source GitHub

Install

npx -y @mindstone/[email protected]

Configuration Example

{
  "remotes": [],
  "packages": [
    {
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "identifier": "@mindstone/mcp-server-email-imap",
      "version": "0.3.2",
      "runtimeHint": "npx",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "Email address",
          "isRequired": true,
          "format": "string",
          "name": "EMAIL_IMAP_EMAIL"
        },
        {
          "description": "App-specific password",
          "isRequired": true,
          "format": "string",
          "isSecret": true,
          "name": "EMAIL_IMAP_PASSWORD"
        },
        {
          "description": "Provider — icloud, gmail, yahoo, outlook, or custom (auto-detected from email domain if unset)",
          "format": "string",
          "name": "EMAIL_IMAP_PROVIDER"
        },
        {
          "description": "Custom IMAP host (for provider=custom)",
          "format": "string",
          "name": "EMAIL_IMAP_IMAP_HOST"
        },
        {
          "description": "Custom SMTP host (for provider=custom)",
          "format": "string",
          "name": "EMAIL_IMAP_SMTP_HOST"
        },
        {
          "description": "Custom IMAP port",
          "format": "number",
          "default": "993",
          "name": "EMAIL_IMAP_IMAP_PORT"
        },
        {
          "description": "Custom SMTP port",
          "format": "number",
          "default": "587",
          "name": "EMAIL_IMAP_SMTP_PORT"
        },
        {
          "description": "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.",
          "format": "number",
          "default": "25",
          "name": "EMAIL_IMAP_MAX_RECIPIENTS"
        },
        {
          "description": "Safety cap: maximum email_send calls per rolling window. Defaults to 50; protects against runaway sends when injection content escapes the LLM's intent.",
          "format": "number",
          "default": "50",
          "name": "EMAIL_IMAP_RATE_LIMIT_PER_HOUR"
        },
        {
          "description": "Sliding-window length for the rate limit (ms)",
          "format": "number",
          "default": "3600000",
          "name": "EMAIL_IMAP_RATE_LIMIT_WINDOW_MS"
        },
        {
          "description": "Workspace directory that email_get_attachment downloads into (fresh email-imap-attachment-* staging directories). Defaults to the system temp directory.",
          "format": "string",
          "name": "MCP_WORKSPACE_PATH"
        }
      ]
    }
  ]
}

mcp model-context-protocol npm