How to add all your inboxes to Claude Code and Claude Cowork
In short
Run claude mcp add --transport http with your Fezola URL, then /mcp to sign in. Claude Code can then search Gmail, iCloud and IMAP, results naming accounts.
By FezolaPublished Updated 3 min read

On this page
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 does not send by default. Fezola saves drafts in the mailbox that received the message, with that address as the sender. The
send_messagetool is only offered if you have switched on direct sending for a mailbox. 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. While sending stays off, a hijacked agent cannot mail anyone; if you switch sending on, new recipients are flagged and you should review each send.
- 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?.
New to MCP? Start with what is MCP, the Model Context Protocol.
Questions and answers
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?
Not by default. Fezola saves replies as drafts in the mailbox that received the message, and direct sending is off unless you switch it on for a mailbox. 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 unlimited sources for $9 per month or $90 per year, with a 7-day free trial.
More in MCP basics

Best email MCP servers for Claude (and ChatGPT Business) in November 2026
The best email MCP server depends on your setup: built-in for one Gmail, self-hosted for control, hosted like Fezola for several mailboxes. Checked 15 Nov 2026.
9 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.
3 min read

What is an email MCP server, and what can it do with your inbox?
An email MCP server lets Claude or ChatGPT search and draft in your mailbox. What it is, how it works, what it can read and change, and what to check first.
2 min read