Agenticmail MCP Server
Agenticmail MCP Server is an MCP server that adds messaging tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Real email and SMS for AI agents — send mail, receive verification codes, drive a real inbox. It has 241 GitHub stars, is released under the MIT license and runs locally with npx -y @agenticmail/mcp.
github.com/agenticmail/agenticmail (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
- Needs API key
- Communication
- MIT
- Active
Install Agenticmail MCP Server
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"agenticmail-mcp-server": {
"command": "npx",
"args": [
"-y",
"@agenticmail/mcp"
],
"env": {
"AGENTICMAIL_API_KEY": "your-value",
"AGENTICMAIL_MASTER_KEY": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env AGENTICMAIL_API_KEY=your-value --env AGENTICMAIL_MASTER_KEY=your-value --transport stdio agenticmail-mcp-server -- npx -y @agenticmail/mcpCursor
{
"mcpServers": {
"agenticmail-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agenticmail/mcp"
],
"env": {
"AGENTICMAIL_API_KEY": "your-value",
"AGENTICMAIL_MASTER_KEY": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"inputs": [
{
"type": "promptString",
"id": "agenticmail_api_key",
"description": "AGENTICMAIL_API_KEY",
"password": true
},
{
"type": "promptString",
"id": "agenticmail_master_key",
"description": "AGENTICMAIL_MASTER_KEY",
"password": true
}
],
"servers": {
"agenticmail-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agenticmail/mcp"
],
"env": {
"AGENTICMAIL_API_KEY": "${input:agenticmail_api_key}",
"AGENTICMAIL_MASTER_KEY": "${input:agenticmail_master_key}"
}
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
AGENTICMAIL_API_KEYsecret | No | Per-agent API key issued when you create the agent. Scopes every tool call to that agent's mailbox and outbound. Either AGENTICMAILAPIKEY or… |
AGENTICMAIL_MASTER_KEYsecret | No | Master key for admin operations (creating agents, listing all accounts, deleting agents). Set this when the MCP client needs admin tools; otherwise prefer the… |
AGENTICMAIL_API_URL | No | Base URL of the AgenticMail HTTP API. Defaults to http://127.0.0.1:3100 (the port the local CLI binds). Override when the API runs on a different host or port. |
Tools (40)
Parsed from the Tools section of the README; check the repository for the current list.
send_emailSend email with to, subject, text/html, attachments, CC
list_inboxList recent inbox messages (paginated, up to 100)
read_emailRead full email content with security analysis
reply_emailReply (or reply-all) preserving threading
forward_emailForward an email with original attachments
search_emailsSearch by from, subject, body, date range, relay
delete_emailDelete a specific email by UID
move_emailMove email to a folder
mark_readMark email as read
mark_unreadMark email as unread
inbox_digestGet inbox summary with body previews
wait_for_emailWait for new email in real time (up to 5 minutes)
import_relay_emailImport email from connected Gmail/Outlook
batch_deleteDelete multiple emails by UID list
batch_mark_readMark multiple emails as read
batch_mark_unreadMark multiple emails as unread
batch_moveMove multiple emails to a folder
batch_readRead multiple full emails at once
manage_contactsAdd, remove, and list contacts in address book
manage_draftsCreate, list, edit, delete, and send drafts
manage_tagsCreate tags, assign to messages, remove, list
manage_rulesCreate email filtering rules (auto-move, auto-delete, mark read)
manage_signaturesCreate, list, and delete email signatures
manage_templatesCreate, list, and delete email templates
manage_scheduledSchedule emails for future delivery, list, cancel
manage_spamList spam folder, report spam, mark as not-spam, get spam score
manage_pending_emailsView blocked outbound emails awaiting approval
template_sendSend email using a saved template with variable substitution
create_folderCreate a new IMAP folder
list_folderList messages in a specific folder
list_foldersList all available folders
check_healthCheck AgenticMail server and Stalwart health
list_agentsList all agents with name, email, role
message_agentSend email to another agent (with priority levels)
check_messagesCheck for new messages from agents and externals
call_agentCall another agent with a task (sync or async)
claim_taskClaim a pending task assigned to you
submit_resultSubmit result for a claimed task
check_tasksCheck incoming or outgoing tasks
create_accountCreate a new agent with name and role
About Agenticmail MCP Server
The MCP (Model Context Protocol) server for AgenticMail — gives any MCP-compatible AI client full email and SMS capabilities.
- agent
- ai
- ai-agent
- imap
- mcp
- openclaw
- smtp
- typescript
- messaging
Similar MCP servers
More communication MCP servers
three.ws Notifications
nirholas/three.ws
Read the inbox, mark items read, manage delivery preferences, and register Web Push devices.
Active · last commit Oct 25, 2026
CommunicationJavaScriptApple Mail MCP
patrickfreyer/apple-mail-mcp
MCP server giving AI assistants full access to Apple Mail - read, search, compose, organize & analyze emails via natural language.
Active · last commit Oct 21, 2026
CommunicationPythonAtomic Mail
Atomic-Mail/atomic-mail-agentic
Programmable email inbox for AI agents — JMAP, PoW auth, stdio MCP server.
Active · last commit Oct 22, 2026
CommunicationTypeScriptParse-DMARC MCP Server
dmarcguardhq/parse-dmarc
Lightweight DMARC parser: auto-fetch email reports, visualize compliance in a single all-in-one app.
Active · last commit Oct 25, 2026
OfficialCommunicationGoSynaplan
metadist/synaplan
Self-hosted AI workspace: semantic RAG document search, long-term memory, and AI chat via MCP.
Active · last commit Oct 26, 2026
CommunicationPHPAutopilot Jobhunt
tarunlnmiit/autopilot-jobhunt
Agentic job hunt: scan careers pages, score against your resume, draft applications.
Active · last commit Sep 15, 2026
CommunicationPython
How do I install the Agenticmail MCP Server MCP server?
Add the command npx -y @agenticmail/mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is Agenticmail MCP Server free?
The server is open source under the MIT license, so running it is free. It needs credentials (AGENTICMAIL_API_KEY and AGENTICMAIL_MASTER_KEY) for the service it connects to, which may require a paid account.
Is Agenticmail MCP Server actively maintained?
The most recent commit was on Sep 13, 2026. The latest release is agenticmail-cli-v0.9.104, published Jun 5, 2026. appsgit only lists MCP servers with a commit in the last six months.