albretsen avatar

MCPEmails

albretsen/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 tools

Public 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*secret

MCPEmails 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.

Glama quality grade npm version MCP registry License: AGPL-3.0


View the full README on GitHub

Details

Repository
github.com/albretsen/mcpemails
Website
mcpemails.com
Category
Communication & Messaging
Package
mcpemails
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

Related Communication & Messaging MCP servers

View all
1sns45 avatarBetter Call Claudesns45/better-call-claudeVoice Calls, SMS, and WhatsApp for Claude Code with cross-channel context sharing.2stars
2shanjai-raj avatarCommuneshanjai-raj/commune-mcpEmail and SMS MCP server for AI agents — 41 tools for inboxes, sending, search, and SMS.1stars
3andreaacanfora avatarA2H: ask a humanandreaacanfora/a2h-gatewayAsk a human before acting: approvals by email, Telegram or push, signed answers, passkeys.0stars
4eztexting avatarEZTexting MCPeztexting/mcp-serverOfficial EZTexting MCP server: SMS/MMS messaging, contacts, workflows, reports.0stars
5mailbox-mcp avatarMailbox MCPcom.mailbox-mcp/mailbox-mcpRead, send, file and search email in any Gmail, Microsoft 365 or IMAP mailbox, plus its calendar.0stars
6pingfyr avatarPingfyrpingfyr/mcpSchedule reminders for AI agents via email, webhook, Slack, Discord, Telegram, or Google Calendar.0stars