SMTP MCP Server: Install & Setup

Install SMTP in Claude Code

npm

Claude Code

claude mcp add smtp -e SMTP_HOST=... -e SMTP_USER=... -e SMTP_PASSWORD=... -e SMTP_FROM=... -- npx -y @ni-c/smtp-mcp

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "smtp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/smtp-mcp"
      ],
      "env": {
        "SMTP_HOST": "...",
        "SMTP_USER": "...",
        "SMTP_PASSWORD": "...",
        "SMTP_FROM": "..."
      }
    }
  }
}

Docker

Claude Code

claude mcp add smtp -e SMTP_HOST=... -e SMTP_USER=... -e SMTP_PASSWORD=... -e SMTP_FROM=... -- docker run -i --rm -e SMTP_HOST -e SMTP_USER -e SMTP_PASSWORD -e SMTP_FROM ghcr.io/ni-c/smtp-mcp:0.2.0

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "smtp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SMTP_HOST",
        "-e",
        "SMTP_USER",
        "-e",
        "SMTP_PASSWORD",
        "-e",
        "SMTP_FROM",
        "ghcr.io/ni-c/smtp-mcp:0.2.0"
      ],
      "env": {
        "SMTP_HOST": "...",
        "SMTP_USER": "...",
        "SMTP_PASSWORD": "...",
        "SMTP_FROM": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the SMTP MCP server do?

Send, reply to and forward mail over SMTP, restricted to a recipient allowlist, with each message approved by a person before sending.

Is the SMTP MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does SMTP run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add SMTP to Claude Code?

Run: claude mcp add smtp -e SMTP_HOST=... -e SMTP_USER=... -e SMTP_PASSWORD=... -e SMTP_FROM=... -- npx -y @ni-c/smtp-mcp

More communication MCP servers

View all

ThunderPhone

Build, test and run AI phone agents: numbers, inbound and outbound calls, campaigns and transcripts.

Local + RemoteAccount needed

SendGrid Secure

Choppaaahh/sendgrid-mcp-secure

Security-focused SendGrid email sending with recipient/domain allowlists, send caps, review mode, an audit log and no silent BCC.

LocalAccount neededPython

Vaemail

0392

vaemail/vaemail-mcp

Send transactional email, authenticate sending domains, track delivery and diagnose deliverability, with scoped API keys and dry-run mode.

LocalAccount neededTypeScript

Paigy

paigy-ai/mcp

Call, text or push-notify the user's phone when an agent needs input mid-task, and let them reply by voice.

LocalAccount neededTypeScript

ActivitySmith

AI agents and scripts reporting back to your iPhone with Push Notifications and Live Activities.

RemoteAccount needed

Outlook Mailbox Tidier

ma2no4413/outlook-mcp

Restructure large Outlook/Hotmail mailboxes: move folder subtrees, bulk move and mark-read with dry-run previews, and manage inbox rules. Cannot send mail.

LocalFreePython