Email MCP server
io.github.marlinjai/email-mcp·v1.2.3·22 starsUnified email MCP server for Gmail, Outlook, iCloud, and IMAP with batch operations
22 stars509 downloads/wk
Reviews
Write oneNobody has reviewed Email yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Email tools (24, 24 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
email_add_accountwrite actionAdd a new IMAP or iCloud email account (Gmail and Outlook require the setup wizard for OAuth)
email_batch_deletewrite actionDelete multiple emails at once. Much faster than individual deletes.
email_batch_markwrite actionMark multiple emails at once (read/unread, starred, flagged). Much faster than individual marks.
email_batch_movewrite actionMove multiple emails to a folder at once. Much faster than individual moves.
email_deletewrite actionDelete an email (moves to trash by default, or permanently deletes)
email_draft_createwrite actionCreate a new email draft
email_draft_listwrite actionList email drafts
email_folder_createwrite actionCreate a new email folder
email_forwardwrite actionForward an email to new recipients
email_getwrite actionGet a single email by ID
email_get_attachmentwrite actionGet an email attachment by ID, returns base64 encoded data
email_get_categorieswrite actionList all categories for an email account (Outlook only)
email_get_labelswrite actionList all labels for an email account (Gmail only)
email_get_threadwrite actionGet an email thread by thread ID
email_labelwrite actionAdd or remove labels on an email (Gmail only)
email_list_accountswrite actionList all configured email accounts and their connection status
email_list_folderswrite actionList all email folders for an account
email_markwrite actionMark an email as read/unread, starred, or flagged
email_movewrite actionMove an email to a different folder
email_remove_accountwrite actionRemove an email account
email_replywrite actionReply to an existing email
email_searchwrite actionSearch emails with filters. By default returns compact results without full body content to save context. Set returnBody=true to include full email bodies.
email_sendwrite actionSend a new email
email_test_accountwrite actionTest an email account connection
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan3 source files scanned20/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 1 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- mediumeval / new Function used
exec.evaldist/index.js: …ode, sch); const makeValidate = new Function(`${names_1.default.self}`, `${names_1.de…
How Email compares
Against every graded Email MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 85/100
- higher than 78% of 916 Email servers
- Tools
- 24
- the typical Email server has 7
- Tools that change things
- 100%
- typical: 25%. Fewer write tools means less an agent can break
- GitHub stars
- 22
- more than 91% of 493 Email servers
- Downloads a week
- 509
- more than 84% of 235 Email servers with a package
What its tools let an agent do: 24 send or post
Install Email in Claude Code, Cursor or VS Code
Runs npx -y @marlinjai/email-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add email-mcp -- npx -y @marlinjai/email-mcp
What the publisher says
From the Email repository's README, as published. We do not edit it. Read it on GitHub
@marlinjai/email-mcp
A unified MCP server for email access across Gmail, Outlook, iCloud, and generic IMAP providers.
Features
- Multi-provider support -- Gmail (REST API), Outlook (Microsoft Graph), iCloud (IMAP), and generic IMAP/SMTP
- OAuth2 authentication -- Browser-based OAuth flows for Gmail and Outlook, with automatic token refresh
- Full email client -- Search, read, send, reply, forward, organize, and manage drafts
- Batch operations -- Delete, move, or mark hundreds of emails in a single call
- Lightweight search -- Compact search results by default (~20KB vs ~1.4MB) with optional full body retrieval
- Encrypted credential storage -- AES-256-GCM encryption at rest with machine-derived keys
- Provider-native APIs -- Uses Gmail API and Microsoft Graph where available for richer features, falls back to IMAP for universal compatibility
Installation
Install globally from npm:
npm install -g @marlinjai/email-mcpOr run directly with npx (no install needed):
npx @marlinjai/email-mcpQuick Start
- Run the interactive setup wizard to add your email accounts:
npx -y -p @marlinjai/email-mcp@latest email-mcp-setupThe -p/--package flag is required. This package declares two binaries (email-mcp for the MCP server, email-mcp-setup for this wizard). Without -p, npx runs the bin matching the package's own name (email-mcp, the server) and silently passes email-mcp-setup to it as an ignored argument — the server then sits waiting for MCP protocol input on stdin forever, producing no output at all. It looks exactly like a hang. -p tells npx explicitly which package to resolve and which of its binaries to actually run.
The wizard will walk you through provider selection and authentication. After each account, it asks if you'd like to add another — so you can set up Gmail, Outlook, and iCloud all in one go.
- Add the server to your MCP configuration (.mcp.json):
{
"mcpServers": {
"email": {
"command": "npx",
"args": ["@marlinjai/email-mcp"]
}
}
}- Start using email tools in Claude Code — search your inbox, send emails, organize messages, and more.
Provider Setup Guides
Gmail
No configuration needed — the setup wizard handles everything using built-in OAuth credentials (PKCE):
npx -y -p @marlinjai/email-mcp@latest email-mcp-setup
# Select "Gmail" when prompted
# Choose "Full" or "Restricted" permission scope when asked
# A browser window opens for Google authorization
# Grant the requested permissions and return to the terminalThe wizard asks which Gmail permission scope to authorize:
- Full (default) — everything below, plus immediate, Trash-bypassing permanent deletion (https://mail.google.com/, Gmail's maximum-permission scope).
- Restricted — read, send, label, archive, and move-to-trash (gmail.modify + gmail.settings.basic), but no permanent deletion. Every tool in this server works identically under Restricted except an explicit permanent: true delete, which fails with a Gmail API error instead of succeeding.
Pass --scope full or --scope restricted to skip the prompt, or set EMAILMCPGMAIL_SCOPE=restricted in the environment the wizard runs in.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Email: common questions
- Is Email MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the Email safety report
- How do I install Email?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Email need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Email maintained?
- The last commit was 38 days ago (2026-09-27). The latest release is v1.2.3.
- What can I use instead of Email?
- Servers from other publishers that do the same job: Mailoo - Email MCP Server, Inbox Zero MCP server and Fluxmail MCP server. Compare all Email alternatives.
- How does Email compare with other Email MCP servers?
- safety score 85/100 (higher than 78% of 916 Email servers); tools 24 (the typical Email server has 7); tools that change things 100% (typical: 25%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Email
Same job from other publishers: the closest match first, then the best rated.
- Mailoo - Email MCP ServerEmail MCP server for AI agents: IMAP/SMTP, Gmail, Outlook, calendar, ManageSieve, AI triage, OAuth2.5.0(1)GrowingA
Inbox ZeroSearch Gmail and Outlook, save drafts, manage email rules, and view email stats.not reviewedEstablishedA- FluxmailRead, search, draft, send, and organize email through Gmail, Outlook, and IMAP/SMTP mailboxes.not reviewedGrowingB
- MCPEmailsNever-stored live email: read, send and triage Gmail, Outlook / Microsoft 365, or any IMAP mailbox.not reviewedGrowingA
- GmailGmail integration with OAuth authentication, message search, batch operations, and Sheets exportnot reviewedGrowingC