boutquin avatar

Email (IMAP/SMTP)

boutquin/mcp-server-email

Connects Claude to your email accounts over IMAP and SMTP with 22 tools for reading, sending, searching, and organizing messages. Supports multiple accounts simultaneously with connection pooling and rate limiting. Auto-detects settings for Gmail, Outlook, Yahoo, iCloud, Fastmail, and Zoho from the email domain, or you can configure custom mail servers manually. Handles OAuth2 device flow for Gmail and Outlook, or use app passwords. Built in Go with proper retry logic and TLS. If you need Claude to manage email across personal and work accounts without switching contexts, or you want the remote equivalent of local Mail.app access, this handles the protocol work so you can just ask Claude to find that receipt or follow up on a thread.

GitHub stars
2
tools
22
auth
Secret needed
transport
STDIO
env vars
2
last updated
Mar 13, 2026

Tools

22 tools

Public tool metadata for what this MCP can expose to an agent.

email_accountsList configured accounts with connection status

List configured accounts with connection status

No parameter schema in public metadata yet.

email_foldersList all folders with unread/total counts

List all folders with unread/total counts

No parameter schema in public metadata yet.

email_folder_createCreate new folder

Create new folder

No parameter schema in public metadata yet.

email_listList messages in folder

List messages in folder

No parameter schema in public metadata yet.

email_unreadList unread messages

List unread messages

No parameter schema in public metadata yet.

email_searchSearch subject and body

Search subject and body

No parameter schema in public metadata yet.

email_getGet full message by ID

Get full message by ID

No parameter schema in public metadata yet.

email_read_bodyRead email body with pagination

Read email body with pagination

No parameter schema in public metadata yet.

email_moveMove message to folder

Move message to folder

No parameter schema in public metadata yet.

email_copyCopy message to folder

Copy message to folder

No parameter schema in public metadata yet.

email_deleteDelete message (trash or permanent expunge)

Delete message (trash or permanent expunge)

No parameter schema in public metadata yet.

email_mark_readMark as read/unread

Mark as read/unread

No parameter schema in public metadata yet.

email_flagFlag/unflag message

Flag/unflag message

No parameter schema in public metadata yet.

email_replyReply to a message (sets In-Reply-To, References, quotes body)

Reply to a message (sets In-Reply-To, References, quotes body)

No parameter schema in public metadata yet.

email_forwardForward a message (re-attaches original attachments)

Forward a message (re-attaches original attachments)

No parameter schema in public metadata yet.

email_batchBatch operations on multiple messages

Batch operations on multiple messages

No parameter schema in public metadata yet.

email_attachment_listList attachments on a message

List attachments on a message

No parameter schema in public metadata yet.

email_attachment_getDownload attachment by index

Download attachment by index

No parameter schema in public metadata yet.

email_threadGet conversation thread (searches across INBOX, Sent, Archive, and All Mail)

Get conversation thread (searches across INBOX, Sent, Archive, and All Mail)

No parameter schema in public metadata yet.

email_sendSend via SMTP with optional attachments

Send via SMTP with optional attachments

No parameter schema in public metadata yet.

email_draft_createSave draft with optional attachments

Save draft with optional attachments

No parameter schema in public metadata yet.

email_draft_sendSend existing draft

Send existing draft

No parameter schema in public metadata yet.

Sponsors

Configuration

EMAIL_CONFIG_FILE

Path to account JSON config file

EMAIL_ACCOUNTSsecret

Inline JSON array of account configs

Readme

mcp-server-email

CI codecov Go License: MIT MCP

Multi-account email server for the Model Context Protocol. Gives LLMs full email access — read, send, search, organize — over IMAP/SMTP with connection pooling, rate limiting, and retry. Designed as the remote-email counterpart to apple-bridge (local Mail.app access).

Quick Start

  1. Install

    go install github.com/boutquin/mcp-server-email/cmd/mcp-server-email@latest
    
  2. Create a config file (~/.config/mcp-email/accounts.json)


View the full README on GitHub

Details

Repository
github.com/boutquin/mcp-server-email
Category
Communication & Messaging
Package
ghcr.io/boutquin/mcp-server-email:latest
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Communication & Messaging MCP servers

View all
1faithk7 avatarFaithk7 Gmail Mcpfaithk7/gmail-mcpManage Gmail messages, threads, labels, drafts, and settings from your workflows. Send and organiz…0stars
2prelim avatarPrelimchat.prelim/prelimRead AI preliminary phone screens — your roles, candidate scores, transcripts, and analytics.0stars
3mcp-z avatarGmailio.github.mcp-z/mcp-gmailGmail integration with OAuth authentication, message search, batch operations, and Sheets export0stars
4pulsemcp avatarGmailpulsemcp/mcp-serversMCP server for Gmail with OAuth2 (personal) and service account (Workspace) support.0stars
5waystation-ai avatarGmailwaystation-ai/mcpRead emails, send messages, and manage labels in your Gmail account.0stars
6pasympa avatardiscord-mcppasympa/discord-mcpRun your Discord server from Claude, Cursor or VS Code: messages, moderation, roles, forums, events32stars