Log inSubmit server
Email MCP logo

Email MCP

by marlinjai

Manage Gmail, Outlook, iCloud, and IMAP email accounts through MCP tools for reading, sending, organizing, and batch operations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Email MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "marlinjai-email-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@marlinjai/email-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 33 tools correctly (1mo ago).

Overview

The marlinjai/email-mcp MCP server exposes email account management, search, messaging, organization, and moderation tools through MCP. It connects to Gmail through the Gmail REST API, Outlook through Microsoft Graph, and iCloud or other providers through IMAP/SMTP. OAuth2 setup is built in for Gmail and Outlook, while iCloud and generic IMAP accounts use provider credentials configured through the setup wizard. Reach for it when an agent needs to work across multiple inboxes or perform bulk email actions without returning large message bodies or attachments through the model.

Use cases

  • Search messages across Gmail, Outlook, iCloud, and IMAP accounts
  • Send replies and forwards from a configured account
  • Batch-delete, move, or mark large groups of emails
  • Transfer messages between configured email accounts
  • Save large attachments directly to local disk

Key features

  • Multi-provider email access
  • OAuth2 for Gmail and Outlook
  • IMAP/SMTP support
  • Batch message operations
  • Encrypted credential storage
  • Direct attachment saving

Tools33

What Email MCP lets your agent do. Expand a tool for its parameters.

Verified live~4.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

17/20 checks healthy over the last 77d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @marlinjai/email-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars26Stargazers on the source repository.
npm downloads1.6kPackage downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed33Callable tools this server registers over MCP.
Directory activity8 viewsConfig copies, upvotes, and views on AllMCPs.

How Email MCP works

What marlinjai/email-mcp does

The marlinjai/email-mcp MCP server gives an MCP client a unified interface for Gmail, Outlook, iCloud, and generic IMAP/SMTP accounts. It supports account setup and connection checks, folder discovery, filtered message search, full-message retrieval, thread retrieval, sending, replies, forwarding, and draft management.

Organization features cover moving, deleting, marking, labeling, and creating folders. Gmail-specific operations include labels, while Outlook-specific operations include categories. Spam tools report messages to the provider's own spam or junk filter, rather than sending an abuse report to a security team. Standing block rules can intercept future messages matching supported patterns; these rules are unavailable for iCloud and generic IMAP accounts.

How it works

Gmail and Outlook use browser-based OAuth2 flows with automatic token refresh. Gmail can use either a full permission scope or a restricted scope; permanent deletion requires the full scope. iCloud uses an Apple app-specific password, and generic IMAP accounts use the server details and credentials supplied during setup, with optional SMTP settings for sending.

Provider-native APIs are used for Gmail and Microsoft Graph where available. IMAP provides compatibility for iCloud and other supported mail servers. Credentials are stored with AES-256-GCM encryption using machine-derived keys. The server can transfer messages between configured accounts by importing raw MIME data, preserving message content and metadata. When requested, it moves the source copy to trash only after the destination import is confirmed.

Setup and configuration

Install the npm package or run the server with npx. The separate setup wizard walks through provider selection, authentication, and adding multiple accounts. After setup, register the server as an MCP process, using the package's server command rather than the setup wizard.

Gmail and Outlook normally use the OAuth credentials bundled with the package. Developers who need their own OAuth applications can provide Gmail client ID and client secret variables, or an Outlook client ID, before running setup. The downloads directory used by attachment saving defaults to /home/user/.email-mcp/downloads and can be changed with EMAIL_MCP_DOWNLOADS_DIR.

Tools and capabilities

The marlinjai/email-mcp MCP server includes tools for:

  • Listing, adding, removing, and testing accounts
  • Listing folders, labels, and Outlook categories
  • Searching with compact results by default, then retrieving bodies when needed
  • Reading individual messages, threads, and attachments
  • Saving attachments directly to the configured downloads directory
  • Sending, replying, forwarding, and creating or listing drafts
  • Moving, deleting, marking, labeling, and creating folders
  • Deleting, moving, marking, and reporting spam for multiple messages in one call
  • Transferring or copying messages between configured accounts
  • Creating and auditing supported standing block rules

Attachment retrieval can return base64 data, while the save operation returns metadata after writing the file locally. Batch operations use provider-specific batching where available and sequential fallback behavior for compatibility.

Limitations and notes

Gmail labels and Outlook categories are provider-specific, so those tools do not provide equivalent functionality across every account type. Block rules require a server-side rule mechanism: they are not supported on iCloud or generic IMAP. Outlook block-rule creation needs the MailboxSettings.ReadWrite permission, and previously authorized accounts may need to complete setup again to grant it.

IMAP messages are immutable for draft updates. On iCloud and generic IMAP, updating a draft deletes the old message and creates a new one, so the returned identifier must replace the previous identifier. Gmail restricted authorization cannot perform an explicit permanent delete. Saved attachment paths are relative to the fixed downloads directory and cannot escape it.

The package README demonstrates configuration for Claude Code. It does not document compatibility with a specific other MCP client.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Email MCP

Run `npx -y @marlinjai/email-mcp`, or install `@marlinjai/email-mcp` globally with npm.

Run the package's `email-mcp-setup` wizard. Select Gmail or Outlook, then complete the browser-based OAuth authorization.

Yes. Select iCloud in the setup wizard and provide the iCloud address and an Apple app-specific password.

Yes. `email_save_attachment` writes the attachment under the configured downloads directory and returns metadata instead of base64 content.

Related MCP servers

All in Communication All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewEmail MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/marlinjai-email-mcp?style=directory)](https://allmcps.com/mcp/marlinjai-email-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/marlinjai-email-mcp"><img src="https://allmcps.com/api/badge/marlinjai-email-mcp?style=directory" alt="Email MCP on AllMCPs" /></a>