Advertise
MCP.so
Sign In

Email MCP Server

@marlinjai

Repository

Basic information

Category

Communication

Transports

stdio

Author

marlinjai

Submitted by

Marlin Jai

About Email MCP Server

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

#email#gmail#outlook#icloud#imap#smtp#oauth#mcp#claude#ai

Email MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "@marlinjai/email-mcp"
      ]
    }
  }
}

Email MCP Server tools

25

List 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?

  1. Run the setup wizard with npx @marlinjai/email-mcp setup to configure accounts.
  2. Add the server block to your MCP configuration (e.g., "command": "npx", "args": ["@marlinjai/email-mcp"]).
  3. 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

Frequently asked questions

1

Which email providers does Email Mcp support?

Gmail (REST API), Outlook (Microsoft Graph), iCloud (IMAP), and any generic IMAP/SMTP server.

2

Do I need to configure OAuth myself?

No — built-in OAuth2 with PKCE handles Gmail and Outlook authentication automatically, requiring zero manual configuration.

3

How are credentials stored?

Credentials are encrypted at rest using AES-256-GCM encryption.

4

What is the limit for batch operations?

Batch delete, move, or mark operations can handle up to 1,000 emails in a single call.

5

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.

Comments

More Communication MCP servers

Ghostedit

Ghostedit

Post to Instagram, TikTok, YouTube, Threads, LinkedIn, Bluesky and Mastodon from Claude, ChatGPT or Claude Code. Every post is checked against each platform's rules before it goes out, you can see what worked, and Instag

Socialync

Jack Vitick

Draft, schedule, and publish social media posts to 8 platforms from any AI agent: Facebook, Instagram, X, TikTok, YouTube, LinkedIn, Threads, and Bluesky. 19 tools covering drafting, scheduling, publishing, media upload,

Paddock Cards

Paddock

Send birthday cards, Christmas cards and postcards, printed and mailed for you.

Upfirst

Upfirst is an AI phone receptionist for small businesses. Review call transcripts, then fix the greeting, knowledge, and transfer rules from your AI client.

atbridge.ai

atbridge-ai

Local MCP server for Thunderbird. Gives Claude Desktop, Cursor, or any MCP client read/write access to multiple mailboxes, calendars, contacts, notes & tasks (Gmail, Outlook, IMAP) — all on your machine.

Advertise