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 233 GitHub stars, is released under the MIT license and runs locally with npx -y @agenticmail/mcp.
- Needs API key
- Communication
- MIT
- Actively maintained
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
Strata
Klavis-AI/klavis
MCP server for progressive tool usage at any scale (see https://klavis.ai).
OfficialCommunicationPythonVexa
Vexa-ai/vexa
Meeting bot and transcripts for Google Meet, Teams and Zoom.
OfficialCommunicationPythonMCP Server for WinDbg Crash Analysis
svnscha/mcp-windbg
A Model Context Protocol server for Windows crash dump analysis using WinDbg/CDB.
CommunicationPythonRocketmq Rust
mxsm/rocketmq-rust
π Apache RocketMQ built in Rust π¦ β faster, safer, and more memory-efficient.
CommunicationRustWassette
microsoft/wassette
Wassette: A security-oriented runtime that runs WebAssembly Components via MCP.
OfficialCommunicationRustLine Bot MCP Server
line/line-bot-mcp-server
MCP server that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.
OfficialCommunicationTypeScript
What is 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 233 GitHub stars, is released under the MIT license and runs locally with npx -y @agenticmail/mcp. The source code is at github.com/agenticmail/agenticmail.
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 and re-checks every server daily.