Mailbridge MCP server

Mailbridge MCP

Connect your AI assistant to your email — read, search, send, reply, organise, draft, schedule, and manage attachments from iCloud or any IMAP account. Works with Claude, OpenAI Codex, Cursor, Windsurf, and any MCP-compatible client.

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

Features

Reading & Search

• Read emails — fetch inbox, any folder, with subject/sender/date
• Inbox digest — smart summary with priority scoring, categories, and action suggestions
• Search — find emails by keyword, sender, or subject
• Thread view — see the full conversation thread for any email
• Contact history — view all emails to/from a specific contact
• Unified inbox — merge multiple folders into one date-sorted view
• Priority scoring — every email is automatically scored 1–5 for urgency
• Auto-categorisation — emails are tagged Finance, Travel, Calendar, Newsletter, and more

Sending & Drafts

• Send & reply — compose new emails or reply with threading
• Send attachments — attach local files or inline content to any outgoing email
• Smart drafts — save emails locally for review before sending
• Email scheduling — schedule emails to send at a future time
• Read receipts — optionally request confirmation when a sent email is opened (recipient-dependent; see Read Receipts)

Organisation

• Bulk actions — mark, move, or delete multiple emails in one command
• Follow-up reminders — tag an email "remind me in 3 days" and it surfaces in your next digest
• Unsubscribe — auto-unsubscribe from mailing lists via List-Unsubscribe headers
• Email rules — define local rules to flag, categorise, or prioritise emails automatically
• Move, delete, mark — standard inbox management tools

Attachments & Content

• Read attachments — PDF, DOCX, TXT, JPG, PNG, MP3, MP4 and more
• Attachment safety — every attachment is scanned before download; dangerous file types are blocked
• Export email — export any email as clean Markdown
• Calendar extraction — pull event details (dates, times, locations) from emails and .ics files

Accounts

• Multiple accounts — connect and switch between accounts
• Secure credentials — passwords stored in OS keychain, never in plain text

Install

Claude Cowork

1. Go to Customize → Connectors → Browse Plugins → "+" sign
2. Add marketplace source: https://github.com/Creativestefan/mailbridge-mcp
3. Start a new chat — and enter Open Mailbridge setup to open the setup portal and connect your email account
4. For iCloud emails you will need to create an App specfic password to access your email securely. Using your real password will fail to authenicate.
5. To reopen setup at any time: "open Mailbridge setup"

To update later: Customize → Connectors → Browse Plugins → (...) button and Click Check for update

OpenAI Codex

1. Add the Mailbridge marketplace:

codex plugin marketplace add Creativestefan/mailbridge-mcp --ref main

1. Install the plugin:

codex plugin add mailbridge@mailbridge

1. Start a new Codex thread and test:

Use Mailbridge to check my email connection.

1. If no account is connected yet:

Type "Open Mailbridge setup" and send.

The setup portal saves credentials directly to your OS credential store (macOS Keychain, Windows Credential Manager, or Linux Keyring).

To update later:

codex plugin marketplace upgrade
codex plugin add mailbridge@mailbridge

Cursor

1. Open Cursor Settings → Tools & MCP
2. Click Add MCP Server and paste:

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

Shortened. The full README is on GitHub.