inboxmux
Connects Gmail and Google Workspace mailboxes via OAuth and the Gmail API for read-only search and triage, including message/thread retrieval, label listing, and change tracking.
Supports GoDaddy Professional Email (Titan) through an IMAP preset for read-only mailbox search and triage.
Supports iCloud Mail through an IMAP preset using an app-specific password for read-only mailbox search and triage.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
inboxmux
A self-hosted, remote MCP server that puts many mailboxes behind one connector. Add it to Claude (or any MCP client that speaks Streamable HTTP + OAuth) once, and search and triage mail across all your accounts.
Providers: Gmail and Google Workspace (OAuth), Microsoft 365 and Outlook.com (Microsoft Graph), and any IMAP host. Presets cover GoDaddy Professional Email (Titan), Fastmail, iCloud, Yahoo and Gmail over IMAP.
Read-only. Gmail uses
gmail.readonly, Microsoft usesMail.Read, and IMAP opens folders read-only and never sets\Seen.Built for scheduled triage.
get_changesreturns what arrived since the last run, and delivery is at-least-once: nothing is skipped until youack_changes.Compact output. Search returns summaries. A body is returned only when you ask for one, as plain text with quoted replies collapsed and signatures trimmed.
Treats email as untrusted. Bodies come wrapped in explicit delimiters. Links and remote images are never fetched.
Secure by default. It implements MCP authorization (OAuth 2.1, PKCE, Client ID Metadata Documents and Dynamic Client Registration, rotating refresh tokens). Owners sign in with Google, limited to an email allowlist. Provider secrets are encrypted with AES-256-GCM, and every tool call is audited without storing message content.
Quickstart (Docker Compose)
You need a server with Docker, a DNS name pointing at it, and ports 80 and 443 open.
git clone https://github.com/mkushner/inboxmux && cd inboxmux
cp .env.example .env
docker compose run --rm inboxmux node dist/cli.js gen-key # paste into INBOXMUX_ENCRYPTION_KEY as k1:<key>
# fill in INBOXMUX_DOMAIN, OWNER_EMAILS, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET
docker compose up -dCaddy obtains the TLS certificate. Open https://<your-domain>/admin, sign in with an allowed Google account, and add mailboxes.
Creating the Google OAuth client takes about five minutes. Follow docs/google-cloud.md.
Related MCP server: MailBridge MCP
Connect it to Claude
In Claude, open Settings → Connectors → Add custom connector and enter:
https://<your-domain>/mcpClaude registers itself, then sends you to inboxmux to sign in and approve. After that the connector works in chats and in scheduled tasks. docs/scheduled-triage.md has a ready-made prompt for triaging your inbox three times a day.
Adding accounts
Everything happens at /admin.
Provider | How |
Gmail / Google Workspace | Connect with Google. Needs the Gmail API enabled in the same Google Cloud project (guide). |
Microsoft 365 / Outlook.com | Connect with Microsoft. Needs an Entra app registration (guide). |
IMAP | Pick a preset or enter a host, then a username and an app password. The connection is tested before saving. |
Each account has an alias (personal, work, sales…). Tools take aliases and return ids shaped <alias>:<id>.
IMAP presets:
Preset | Host | Notes |
GoDaddy Professional Email |
| Mailbox password. EU-hosted Titan uses |
Fastmail |
| App password, not available on Basic plans |
iCloud Mail |
| App-specific password, needs two-factor authentication |
Yahoo Mail |
| App password |
Gmail via IMAP |
| App password, needs 2-Step Verification. Skips the Google Cloud setup and supports |
Microsoft 365 mailboxes, including "Microsoft 365 from GoDaddy", disable basic-auth IMAP. Add them with Connect with Microsoft.
Tools
All tools are read-only and annotated readOnlyHint.
Tool | Purpose |
| Aliases, provider, address, health ( |
| Structured filters (from, to, subject, text, since, before, unread, folder, hasAttachment, excludeAutomated) or a provider-native |
| One message as cleaned plain text plus attachment metadata, truncated to |
| A conversation, oldest first. For plain IMAP it is rebuilt from |
| Folders (IMAP, Microsoft) or labels (Gmail) |
| New inbox mail since a named consumer's checkpoint, oldest first, up to |
| Advances the consumer's checkpoint. It changes only inboxmux's read position, never your mailboxes. |
How changes are tracked: Gmail uses historyId, falling back to a time window when history has expired. IMAP uses UIDVALIDITY and UIDNEXT on INBOX. Microsoft uses receivedDateTime on the Inbox folder. A message moved into the Microsoft Inbox from another folder keeps its original received time, so it is not reported as new. Gmail and IMAP do report such moves.
Configuration
Variable | Required | Description |
| yes | External base URL, such as |
| yes |
|
| yes | Comma-separated Google accounts allowed to sign in |
| yes | OAuth client for owner sign-in and Gmail |
| no | Enables Microsoft accounts |
| no |
|
| no | Comma-separated origins MCP clients may redirect to, for example |
| no | SQLite file. The default is |
| no | HTTP port, default |
To rotate the encryption key:
Set
INBOXMUX_ENCRYPTION_KEY=k2:<new>,k1:<old>and restart.Run
docker compose exec inboxmux node dist/cli.js rotate-key.Remove
k1.
Development
Requires Node 22+ and Yarn 4.
yarn install
yarn typecheck && yarn lint && yarn test
# IMAP integration tests against GreenMail
docker compose -f docker-compose.test.yml up -d
yarn test:imapyarn dev runs the server with reload. Use PUBLIC_URL=http://localhost:8080, since the OAuth endpoints allow plain HTTP on localhost only.
Security
See SECURITY.md for the threat model and how to report a vulnerability.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Connect Gmail, iCloud Mail, Outlook, Yahoo Mail, Fastmail and other IMAP inboxes to ChatGPT, Claude and compatible AI assistants. Find emails by meaning across languages with semantic search. Ask AI to find customer conversations, summarize deadlines and draft follow-ups. Give a sales rep access to a shared outreach inbox or bring email into a compatible CRM. Share an iCloud custom-domain inbox with teammates without their own Apple ID or iCloud+ plan. Search results may be incomplete or stale; separate permissions control mail actions.
Your mailboxes in ChatGPT and Claude: Gmail, iCloud, Fastmail, any IMAP. Passwords stay yours.
Connect any IMAP/SMTP mailbox to Claude & ChatGPT: search, read, sort, draft. Sends only with OK.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceA read-only MCP server that gives Claude unified access to multiple Gmail and Microsoft 365 accounts, enabling email search, reading, and listing through one connection.239 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP-compatible AI assistants to securely search multiple mailboxes, reconstruct email threads, and inspect attachments through read-only tools without altering mailbox state.Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables Claude to search and read multiple Gmail or Google Workspace mail accounts at once through a local, read-only MCP server, with every result labeled by the account it came from. Tokens stay in the OS keychain, no server is run by the authors, and write actions such as sending, deleting, or archiving are not supported.6 npm1AGPL 3.0
- AlicenseAqualityBmaintenanceEnables Claude to connect unlimited Gmail and IMAP mailboxes, search and triage them together while identifying each account, read attachments, and create drafts or perform permitted mailbox actions under configurable safety modes.2355 npm1MIT