
Email (IMAP/SMTP)
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 toolsPublic 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_FILEPath to account JSON config file
EMAIL_ACCOUNTSsecretInline JSON array of account configs
Readme
mcp-server-email
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
-
Install
go install github.com/boutquin/mcp-server-email/cmd/mcp-server-email@latest -
Create a config file (
~/.config/mcp-email/accounts.json)
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