Email Mcp
@marlinjai
About Email Mcp
Unified MCP server for email access across Gmail, Outlook, iCloud, and generic IMAP/SMTP. 24 tools for searching, sending, organizing, and batch-managing emails with built-in OAuth2 and encrypted credential storage
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"email": {
"command": "npx",
"args": [
"@marlinjai/email-mcp"
]
}
}
}Tools
25List all configured email accounts and their connection status
Add a new IMAP or iCloud email account (Gmail and Outlook require the setup wizard for OAuth)
Remove an email account
Test an email account connection
List all email folders for an account
Search emails with filters. By default returns compact results without full body content to save context. Set returnBody=true to include full email bodies.
Get a single email by ID
Get an email thread by thread ID
Get an email attachment by ID, returns base64 encoded data
Send a new email
Reply to an existing email
Forward an email to new recipients
Create a new email draft
List email drafts
Move an email to a different folder
Delete an email (moves to trash by default, or permanently deletes)
Mark an email as read/unread, starred, or flagged
Delete multiple emails at once. Much faster than individual deletes.
Move multiple emails to a folder at once. Much faster than individual moves.
Mark multiple emails at once (read/unread, starred, flagged). Much faster than individual marks.
Move or copy emails BETWEEN accounts, preserving the original message intact (sender, date, threading) by transferring the raw MIME. Fetches each message from the source account and imports it into the target account. With deleteAfter=true the source copy is sent to trash only after a confirmed import, making this a safe cross-account move.
Add or remove labels on an email (Gmail only)
Create a new email folder
List all labels for an email account (Gmail only)
List all categories for an email account (Outlook only)
Overview
What is Email Mcp?
Email Mcp is a multi-provider email client exposed through MCP (Model Context Protocol) tools. It integrates with Gmail, Outlook, iCloud, and generic IMAP/SMTP servers, offering 24 tools across account management, reading, sending, organizing, and batch operations. It is built for developers who want to add email automation and management to their MCP‑enabled applications.
How to use Email Mcp?
- Run the setup wizard with
npx @marlinjai/email-mcp setupto configure accounts. - Add the server block to your MCP configuration (e.g.,
"command": "npx", "args": ["@marlinjai/email-mcp"]). - Use the 24 MCP tools to search inbox, send emails, organize messages, or batch delete spam — no further config required.
Key features of Email Mcp
- Multi-provider support: Gmail, Outlook, iCloud, generic IMAP/SMTP
- 24 MCP tools across 5 categories
- Built-in OAuth2 (PKCE) for Gmail and Outlook — zero config
- Batch operations: delete, move, or mark up to 1,000 emails per call
- Lightweight search: compact results (~20 KB vs ~1.4 MB)
- AES-256-GCM encrypted credential storage at rest
Use cases of Email Mcp
- Automate email triage by searching and organizing inbox messages
- Batch delete or move spam, newsletters, or large email volumes
- Send emails programmatically through MCP-enabled assistants
- Integrate multiple email accounts (personal, work, iCloud) under one MCP server
- Perform rapid, lightweight searches on large mailboxes
FAQ from Email Mcp
Which email providers does Email Mcp support?
Gmail (REST API), Outlook (Microsoft Graph), iCloud (IMAP), and any generic IMAP/SMTP server.
Do I need to configure OAuth myself?
No — built-in OAuth2 with PKCE handles Gmail and Outlook authentication automatically, requiring zero manual configuration.
How are credentials stored?
Credentials are encrypted at rest using AES-256-GCM encryption.
What is the limit for batch operations?
Batch delete, move, or mark operations can handle up to 1,000 emails in a single call.
How do I install and set up Email Mcp?
Run npx @marlinjai/email-mcp setup to launch the setup wizard, then add the server to your MCP configuration file.
Frequently asked questions
Which email providers does Email Mcp support?
Gmail (REST API), Outlook (Microsoft Graph), iCloud (IMAP), and any generic IMAP/SMTP server.
Do I need to configure OAuth myself?
No — built-in OAuth2 with PKCE handles Gmail and Outlook authentication automatically, requiring zero manual configuration.
How are credentials stored?
Credentials are encrypted at rest using AES-256-GCM encryption.
What is the limit for batch operations?
Batch delete, move, or mark operations can handle up to 1,000 emails in a single call.
How do I install and set up Email Mcp?
Run `npx @marlinjai/email-mcp setup` to launch the setup wizard, then add the server to your MCP configuration file.
Basic information
More Communication MCP servers
Faxer
1771 CoSend real faxes to any US, Canadian, or international fax number from any AI assistant. The agent quotes the exact price from the document's real page count, hands the human a Stripe Checkout link (payment stays human-in
Mektup-mcp
WeeCiMektup gives AI agents and their humans a real email mailbox, not just a one-way sending API. Through 41 MCP tools, an agent can register a domain, create a mailbox, send and receive mail, and manage threads, drafts, fol
Caulo
PatryCaulo is the social layer of the agentic web: a social network your AI agent reads, briefs you on, and posts to — by prompt. Ad-free, verified humans only, with provenance on every post (human / agent-assisted / agent-au
AgentCouch
Messaging rooms for AI agents: hand off context across tools, worktrees, machines, and teammates. Agents meet in shared rooms over MCP, hand off directly, and leave a replayable transcript; live sessions wake on reply, b
mcp-email-server
ai-zerolabIMAP and SMTP via MCP Server
Comments