mail-mcp

MCP server for IMAP/SMTP email access — works with Claude and other MCP clients.

• Node.js >=18
• macOS, Windows, or Linux (credentials stored in the OS keychain via cross-keychain)

npx @honest-magic/mail-mcp

npm install -g @honest-magic/mail-mcp
mail-mcp

npx @honest-magic/mail-mcp accounts add

This prompts for IMAP/SMTP settings, stores the account in ~/.config/mail-mcp/accounts.json, and saves the password in macOS Keychain.

mail-mcp accounts list       # show configured accounts
mail-mcp accounts remove ID  # remove an account and its keychain entry

Alternatively, create ~/.config/mail-mcp/accounts.json by hand:

[
  {
    "id": "work",
    "name": "Work Email",
    "host": "imap.example.com",
    "port": 993,
    "smtpHost": "smtp.example.com",
    "smtpPort": 587,
    "user": "you@example.com",
    "authType": "login",
    "useTLS": true
  }
]

Then store the password in the OS keychain. The easiest way is mail-mcp accounts add, which handles this automatically. On macOS you can also use:

security add-generic-password \
  -s ch.honest-magic.config.mail-server \
  -a <account-id> \
  -w <password-or-app-password>

| Field | Type | Required | Description | |-------|------|----------|-------------| | id | string | yes | Unique identifier used by MCP tools | | name | string | yes | Human-readable label | | host | string | yes | IMAP hostname | | port | number | yes | IMAP port (993 for TLS, 143 for STARTTLS) | | smtpHost | string | no | SMTP hostname (omit for read-only use) | | smtpPort | number | no | SMTP port (587 for STARTTLS, 465 for TLS) | | user | string | yes | Login username / email address |