Mailbridge MCP Server

Mailbridge MCP

Connect Claude to your email — read, search, send, reply, organise, and read attachments from iCloud or any IMAP account.

Credentials are stored securely in your OS credential store (macOS Keychain, Windows Credential Manager, or Linux Keyring) — never in a file.

---

Features

• Read emails — fetch inbox, any folder, with subject/sender/date
• Inbox digest — smart summary with priorities, finance, events, and action suggestions
• Search — find emails by keyword, sender, or subject
• Send & reply — compose new emails or reply with threading
• Organise — move, delete, mark as read/unread
• Read attachments — PDF, DOCX, TXT, JPG, PNG, MP3, MP4 and more
• Attachment safety — every attachment is scanned before download; dangerous file types are blocked outright
• Multiple accounts — connect and switch between accounts
• Secure credentials — passwords stored in OS keychain, never in plain text

---

Install

Via Claude Cowork (recommended)

Install the .plugin file from the releases page directly in Claude Cowork → Settings → Plugins.

Via npm (standalone MCP server)

npx mailbridge-mcp

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "mailbridge": {
      "command": "npx",
      "args": ["mailbridge-mcp"]
    }
  }
}

---

Setup

On first install, a browser form opens automatically to connect your email account. Credentials go directly into your OS credential store on submit — nothing is written to a file.

To reopen setup at any time, just ask Claude: "open email setup".

iCloud

You must use an App-Specific Password — your main Apple ID password will not work.

Go to account.apple.com → Sign-In & Security → App-Specific Passwords → +, name it "Claude Email", and use the generated password.

Custom IMAP account

Use your full email address and password. The mail server is usually mail.yourdomain.com — check your email provider's settings if unsure.

---

Tools

---

Attachments

Mailbridge scans every attachment before downloading:

Supported file types:

---

Inbox Summary

Ask Claude "catch me up" or "what did I miss?" for a structured digest:

• 🔴 Action Required — emails that need a reply or decision
• 💰 Finance & Billing — invoices, payments, subscription renewals
• 📅 Events & Calendar — meeting invites, travel confirmations, RSVPs
• 📦 Updates & FYI — newsletters, notifications, low-priority

Followed by a "Claude can help you" block with specific suggested actions based on what's in your inbox.

---

Supported Providers

---

Security

• Passwords are stored exclusively in the OS credential store — never written to any file
• The setup portal is a one-time browser form — it starts, collects your credentials, saves them to your OS keychain, then shuts down automatically
• All IMAP and SMTP connections use SSL/TLS
• Attachments are scanned before download — executables and scripts are always blocked
• No data is sent to any Mailbridge server — everything runs locally on your device

---

License

MIT — see LICENSE