
MCPEmails
Live email for your AI agents without the copy. Connect Gmail, iCloud, Fastmail, or any IMAP inbox once, paste the MCP endpoint into Claude Desktop, claude.ai, Cursor, or another client, and your agent can call inbox_list, email_read, email_compose, email_organize, and schedule. Every call hits your provider in real time via Gmail API, JMAP, or IMAP. Message bodies go to the agent and are discarded immediately. Nothing is cached between requests. OAuth clients connect with one click; others use scoped API keys. When your agent sends mail, it goes through your own SMTP server or provider API, so your domain reputation stays yours. Free tier is genuinely unlimited. Reach for this when you want agents drafting replies, triaging support queues, or running scheduled inbox sweeps without handing a third party a standing copy of your mail.
- GitHub stars
- 14
- tools
- 21
- auth
- Secret needed
- transport
- STDIO, HTTP
- env var
- 1
- last updated
- Oct 20, 2026
Tools
21 toolsPublic tool metadata for what this MCP can expose to an agent.
inbox_listLists the inboxes the key can reach, with each one's provider capabilities.
Lists the inboxes the key can reach, with each one's provider capabilities.
No parameter schema in public metadata yet.
email_readLists, reads and searches messages, in batches, plus attachments, extracted attachment text and the original `.eml`.
Lists, reads and searches messages, in batches, plus attachments, extracted attachment text and the original `.eml`.
No parameter schema in public metadata yet.
email_organizeMoves, copies, flags and archives messages you name by id, singly or in batches.
Moves, copies, flags and archives messages you name by id, singly or in batches.
No parameter schema in public metadata yet.
email_search_and_moveMoves every message matching a search into a folder.
Moves every message matching a search into a folder.
No parameter schema in public metadata yet.
email_deleteTrashes or permanently deletes messages, singly, in batches, or by search.
Trashes or permanently deletes messages, singly, in batches, or by search.
No parameter schema in public metadata yet.
email_composeSends, replies and forwards through your own provider, from your real address.
Sends, replies and forwards through your own provider, from your real address.
No parameter schema in public metadata yet.
folder_listLists folders (labels on Gmail) with their provider-native IDs and message counts. Read-only.
Lists folders (labels on Gmail) with their provider-native IDs and message counts. Read-only.
No parameter schema in public metadata yet.
folderCreates, renames and deletes folders (labels on Gmail).
Creates, renames and deletes folders (labels on Gmail).
No parameter schema in public metadata yet.
draft_listLists the drafts saved in the inbox, with their draft ids. Read-only.
Lists the drafts saved in the inbox, with their draft ids. Read-only.
No parameter schema in public metadata yet.
draftCreates, updates, sends and deletes drafts, including provider-native replies.
Creates, updates, sends and deletes drafts, including provider-native replies.
No parameter schema in public metadata yet.
schedule_listLists what is queued for future delivery. Read-only.
Lists what is queued for future delivery. Read-only.
No parameter schema in public metadata yet.
scheduleQueues a message for future delivery, and cancels one that is queued.
Queues a message for future delivery, and cancels one that is queued.
No parameter schema in public metadata yet.
reminder_listLists the follow-ups and snoozes the server tracks: due, upcoming or all. Read-only. Pro and Business.
Lists the follow-ups and snoozes the server tracks: due, upcoming or all. Read-only. Pro and Business.
No parameter schema in public metadata yet.
reminderFollows up on sent mail nobody replied to, and snoozes a message out of the inbox until a time you choose. Runs server-side while the chat is closed. Pro and Business.
Follows up on sent mail nobody replied to, and snoozes a message out of the inbox until a time you choose. Runs server-side while the chat is closed. Pro and Business.
No parameter schema in public metadata yet.
signature_getReads the signature and sender name configured for an inbox. Read-only.
Reads the signature and sender name configured for an inbox. Read-only.
No parameter schema in public metadata yet.
signature_setSets the signature appended to outbound mail, and the sender name.
Sets the signature appended to outbound mail, and the sender name.
No parameter schema in public metadata yet.
automation_readLists triage rules, reads one, shows run history, and dry-runs a filter. Read-only.
Lists triage rules, reads one, shows run history, and dry-runs a filter. Read-only.
No parameter schema in public metadata yet.
automationCreates, updates, enables, disables and deletes unattended triage rules, with no model in the loop.
Creates, updates, enables, disables and deletes unattended triage rules, with no model in the loop.
No parameter schema in public metadata yet.
contact_searchLooks up contacts by scanning recent mail live, with no stored address book.
Looks up contacts by scanning recent mail live, with no stored address book.
No parameter schema in public metadata yet.
draft_readReads one unsent draft in full, for example after the user edited it in the draft editor card. Read-only.
Reads one unsent draft in full, for example after the user edited it in the draft editor card. Read-only.
No parameter schema in public metadata yet.
draft_editor_hideHides or shows the in-chat draft editor card for one inbox or the whole workspace. A display preference only.
Hides or shows the in-chat draft editor card for one inbox or the whole workspace. A display preference only.
No parameter schema in public metadata yet.
Sponsors
Configuration
MCPEMAILS_API_KEY*secretMCPEmails API key: 'mcpe_' followed by 64 hex characters. Create one at https://mcpemails.com/dashboard/keys
Readme
MCPEmails
Give your AI agent an inbox. A hosted Model Context Protocol server that lets Claude, Cursor, or any MCP‑compatible client read, search, send, organize, and schedule email through your existing mailboxes — without ever storing your mail.
Details
- Repository
- github.com/albretsen/mcpemails
- Website
- mcpemails.com
- Category
- Communication & Messaging
- Package
mcpemails- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active