All your inboxes in Claude Code and Claude Cowork
3 min readBy Fezola
Short answer: to add all your inboxes to Claude Code, create a free Fezola account, add your mailboxes, then run claude mcp add --transport http fezola https://api.fezola.com/mcp and type /mcp in Claude Code to sign in. Claude can then search Gmail, iCloud and any IMAP mailbox from your terminal, with every result naming its account. The OAuth part works in production; a full end-to-end test with a real account is still pending, so treat this as "should work" and tell us if something breaks.
Why email in a coding agent
Developers already live in the terminal. Having Claude Code check the thread where a client reported a bug, find the invoice for a cloud bill, or draft a reply while you work saves a context switch. The problem is that a built-in connector usually covers one provider. If you have a Gmail, a work mailbox on your own domain and an iCloud address, you want one connector that holds all of them. That is what an email MCP server does.
What you need
- Claude Code installed, with a recent version that supports remote HTTP MCP servers.
- A free Fezola account with at least one mailbox added in Sources (Gmail, iCloud, OVH, IONOS, Gandi, Yahoo or any IMAP mailbox).
- A browser on the same machine, for the OAuth sign-in.
Step 1: add your mailboxes to Fezola
Create the account, open Sources and add each mailbox with a short name ("Personal", "Work"). Your assistant uses that name to say where each message comes from. Providers that need an app password, such as iCloud, are explained in the all your inboxes guide.
Step 2: add Fezola to Claude Code
Per the Claude Code documentation (checked on 8 November 2026), a remote HTTP server is added with:
claude mcp add --transport http fezola https://api.fezola.com/mcp
By default the server is stored for the current project only (local scope). To use it in all your projects, add --scope user:
claude mcp add --transport http --scope user fezola https://api.fezola.com/mcp
Step 3: sign in with OAuth
Inside Claude Code, run:
/mcp
Select Fezola and follow the browser sign-in. You land on the Fezola consent screen, which lists the sources the assistant will access: accept, and the tools become available. The same login can also be started from your shell with claude mcp login fezola.
What works today, checked by Fezola in production: the client registers itself, receives the authorization page and reaches the consent screen. What is still pending: a complete run with a real account, from the first command to the first answer.
Step 4: check and ask
claude mcp list
shows Connected when it works, Needs authentication if you still have to run /mcp. Then try:
- "What came in on all my mailboxes today that needs an answer?"
- "Find the email where the client reports the checkout bug, in any mailbox."
- "Find the invoice PDF from the hosting provider and tell me the total."
- "Draft a reply to the last email from my accountant, from the right address."
Behind the scenes the agent calls tools such as search_messages, get_thread, get_attachment and reply_draft. Attachments in PDF, Word, text and image formats can be read.
Claude Cowork
According to our information, Claude Cowork reaches the connectors you add in Claude itself (Customize, Connectors, + Add, Add custom connector, paste https://api.fezola.com/mcp). A Fezola connector added there should therefore be available in Cowork. We have not tested this end to end, so check your own setup and tell us what you see.
What a coding agent should and should not do with your mail
- It cannot send by default. Fezola saves drafts in the mailbox that received the message, with that address as the sender. The
send_messagetool exists but is off by default on the server. A coding agent that runs commands should not be able to email people on its own. - Email is untrusted input. A message can contain instructions aimed at the model. Since the connector cannot send, a hijacked agent cannot mail anyone, but still review what it proposes.
- You can cut the access. In Claude Code:
claude mcp logout fezolathenclaude mcp remove fezola. In Fezola,list_connected_assistantsandrevoke_assistantshow which assistants are connected and revoke them.
Other editors and agents are covered in email in Cursor, VS Code, Windsurf and Codex CLI. For a comparison of connector options, see best email MCP servers, and for safety, is it safe to connect your email to an AI?.
Questions
How do I add an email MCP server to Claude Code?
Run claude mcp add --transport http fezola https://api.fezola.com/mcp, then type /mcp inside Claude Code and follow the browser sign-in. Add --scope user to make it available in all your projects.
Does Fezola work with Claude Code today?
The OAuth flow works in production: Claude Code can register, open the authorization page and reach the consent screen. A full end-to-end test with a real account is still pending on our side, so treat the setup below as should-work and tell us if something fails.
What about Claude Cowork?
As far as we know, Cowork uses the connectors you add in Claude (Customize, Connectors), so a Fezola connector added there should be reachable from Cowork. We have not tested it end to end.
Can Claude Code send emails through Fezola?
No by default. Fezola saves replies as drafts in the mailbox that received the message, and the direct send tool is off on the server. You send drafts yourself from your mail app.
How do I remove the connection?
In Claude Code: claude mcp logout fezola, then claude mcp remove fezola. In Fezola, you can also see and revoke connected assistants.
How much does Fezola cost?
Fezola is free for 2 sources. Pro connects up to 20 sources for $9 per month or $90 per year, with a 7-day free trial.
Connect your first inbox in two minutes
Free with 2 sources, no card needed. Nothing to install.
Start for freeKeep reading
· 5 min read
Best email MCP servers for Claude and ChatGPT (November 2026)
An honest comparison of email MCP servers for Claude and ChatGPT: built-in connectors, self-hosted servers and hosted options, with what each one can and cannot do.
Read the article· 3 min read
How to connect a custom domain email to ChatGPT (IMAP, OVH, IONOS, Fastmail)
ChatGPT has no built-in connector for a mailbox on your own domain. Here is how to plug any IMAP mailbox into ChatGPT in a few minutes, step by step.
Read the article· 3 min read
Email in Cursor, VS Code, Windsurf and Codex CLI with one MCP server
Add one email MCP server to Cursor, VS Code, Windsurf or Codex CLI: exact config for each, how the OAuth sign-in works, and what is verified or still untested.
Read the articleIMAP MCP server: connect any mailbox to Claude and ChatGPT
OVH, IONOS, Gandi, Fastmail or a mailbox on your own domain, in Claude and ChatGPT, with nothing to install.
Read the guideHow to bring all your inboxes and chats into Claude or ChatGPT
Gmail, iCloud, your own domain over IMAP, Google Chat and Telegram, searchable together through one connector.
Read the guide