AgenticMail
Real email and SMS for AI agents. Run a local mail server with disposable inboxes — agents send and receive real email, fetch verification codes, and drive a real inbox without going through any third-party email API.
What is AgenticMail?
AgenticMail is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to real email and sms for ai agents. run a local mail server with disposable inboxes — agents send and receive real email, fetch verification codes, and drive a real inbox without going through any third...
Real email and SMS for AI agents. Run a local mail server with disposable inboxes — agents send and receive real email, fetch verification codes, and drive a real inbox without going through any third-party email API.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Real email and SMS for AI agents. Run a local mail server wi
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @agenticmail/mcpManual Installation
npx -y @agenticmail/mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use AgenticMail
AgenticMail provides real email and SMS capabilities for AI agents by running a self-hosted local mail server with disposable inboxes. Unlike API-based email services, AgenticMail runs an actual Stalwart mail server on your machine, allowing agents to send and receive real email, fetch verification codes from inboxes, coordinate multi-agent workflows via RPC, and integrate with SMS/voice through Google Voice. It exposes over 80 MCP tools and 75+ REST API endpoints so any MCP-compatible AI client can drive a real inbox.
Prerequisites
- Node.js 18+ and npm installed (for the CLI installer)
- macOS or Linux (Docker may be required for the Stalwart mail server component)
- AGENTICMAIL_MASTER_KEY for administrative access (generated during setup)
- Optional: an OpenAI API key for voice call bridge features
- An MCP-compatible client such as Claude Desktop or Claude Code
Bootstrap AgenticMail (automated install)
Run the autonomous bootstrap script which installs all dependencies, starts the local Stalwart mail server, and creates a default agent in under two minutes with no prompts.
curl -fsSL https://raw.githubusercontent.com/agenticmail/agenticmail/main/install.sh | bashOr install manually via npm
If you prefer a manual install, install the CLI globally and then run the interactive setup.
npm install -g @agenticmail/cli@latest
agenticmail bootstrapNote your master key and server credentials
After bootstrap completes, save the displayed AGENTICMAIL_MASTER_KEY, SMTP_HOST, SMTP_PORT, IMAP_HOST, IMAP_PORT, and Stalwart admin credentials. You will need these for configuration.
Configure Claude Desktop to use the MCP server
Add the @agenticmail/mcp package to your Claude Desktop configuration. It connects to the local AgenticMail server using your master key.
Create a disposable inbox for your agent
Use the AgenticMail CLI or interactive shell to create a new agent inbox that Claude can send and receive email from.
agenticmail setupVerify the MCP connection and start using email tools
Restart Claude Desktop and ask Claude to send a test email or check an inbox. The MCP server exposes 80+ tools covering send, receive, search, SMS, multi-agent RPC, and memory management.
AgenticMail Examples
Client configuration
Add the AgenticMail MCP server to your claude_desktop_config.json. The server runs via npx using the @agenticmail/mcp package.
{
"mcpServers": {
"agenticmail": {
"command": "npx",
"args": ["-y", "@agenticmail/mcp"],
"env": {
"AGENTICMAIL_MASTER_KEY": "your_master_key_here",
"SMTP_HOST": "127.0.0.1",
"SMTP_PORT": "25",
"IMAP_HOST": "127.0.0.1",
"IMAP_PORT": "143"
}
}
}
}Prompts to try
After connecting, use these prompts with Claude to test AgenticMail's email and coordination capabilities.
- "Send an email to [email protected] with subject 'Hello' and body 'Message from my AI agent'"
- "Check the inbox for [email protected] and show me any unread messages"
- "Fetch the verification code from the latest email in the signup inbox"
- "Search for all emails from [email protected] received in the last 24 hours"
- "Create a new disposable inbox for the onboarding workflow"Troubleshooting AgenticMail
Bootstrap script fails or mail server does not start
Check that ports 25 (SMTP), 143 (IMAP), and 3829 (REST API) are not already in use. Run 'lsof -i :25' to check. On macOS, port 25 may require sudo. If Docker is available, AgenticMail may use it for the Stalwart server—ensure Docker is running before re-running bootstrap.
MCP tools not appearing in Claude Desktop after configuration
Restart Claude Desktop completely after editing claude_desktop_config.json. Verify AGENTICMAIL_MASTER_KEY is correct by testing it directly: 'curl -H "Authorization: Bearer your_key" http://127.0.0.1:3829/api/agenticmail/status'. Check Claude's MCP logs for startup errors.
Emails sent by the agent are rejected or marked as spam
By default, AgenticMail runs a local mail server that may not have proper SPF/DKIM records for external delivery. For sending to external addresses, configure a relay using RELAY_EMAIL and RELAY_PASSWORD pointing to a Gmail or Outlook account. For custom domains, set up CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID.
Frequently Asked Questions about AgenticMail
What is AgenticMail?
AgenticMail is a Model Context Protocol (MCP) server that real email and sms for ai agents. run a local mail server with disposable inboxes — agents send and receive real email, fetch verification codes, and drive a real inbox without going through any third-party email api. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install AgenticMail?
Install via npm with the command: npx -y @agenticmail/mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with AgenticMail?
AgenticMail works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is AgenticMail free to use?
Yes, AgenticMail is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
AgenticMail Alternatives — Similar Communication Servers
Looking for alternatives to AgenticMail? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up AgenticMail in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use AgenticMail?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.