Email (IMAP/SMTP) MCP Setup & Guide

{
  "id": "io.github.mindstone/mcp-server-email-imap",
  "type": "mcp-server",
  "version": "0.3.2",
  "displayName": "Email (IMAP/SMTP)",
  "description": "Email IMAP/SMTP MCP server: iCloud, Gmail, Yahoo, Outlook, and custom IMAP providers",
  "repository": {
    "url": "https://github.com/mindstone/mcp-servers",
    "source": "github",
    "subfolder": "connectors/email-imap"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "@mindstone/mcp-server-email-imap",
        "version": "0.3.2",
        "runtimeHint": "npx",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "EMAIL_IMAP_EMAIL",
            "description": "Email address",
            "isRequired": true
          },
          {
            "name": "EMAIL_IMAP_PASSWORD",
            "description": "App-specific password",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "EMAIL_IMAP_PROVIDER",
            "description": "Provider — icloud, gmail, yahoo, outlook, or custom (auto-detected from email domain if unset)"
          },
          {
            "name": "EMAIL_IMAP_IMAP_HOST",
            "description": "Custom IMAP host (for provider=custom)"
          },
          {
            "name": "EMAIL_IMAP_SMTP_HOST",
            "description": "Custom SMTP host (for provider=custom)"
          },
          {
            "name": "EMAIL_IMAP_IMAP_PORT",
            "description": "Custom IMAP port"
          },
          {
            "name": "EMAIL_IMAP_SMTP_PORT",
            "description": "Custom SMTP port"
          },
          {
            "name": "EMAIL_IMAP_MAX_RECIPIENTS",
            "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."
          },
          {
            "name": "EMAIL_IMAP_RATE_LIMIT_PER_HOUR",
            "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."
          },
          {
            "name": "EMAIL_IMAP_RATE_LIMIT_WINDOW_MS",
            "description": "Sliding-window length for the rate limit (ms)"
          },
          {
            "name": "MCP_WORKSPACE_PATH",
            "description": "Workspace directory that email_get_attachment downloads into (fresh email-imap-attachment-* staging directories). Defaults to the system temp directory."
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.mindstone/mcp-server-email-imap",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.mindstone%2Fmcp-server-email-imap/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}