Agenticmail MCP server
Real email and SMS for AI agents — send mail, receive verification codes, drive a real inbox.
229 stars182 downloads/wk
Reviews
Write oneNobody has reviewed Agenticmail yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Agenticmail tools (62, 23 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
batch_deletewrite actionDelete multiple emails by UIDs
batch_mark_readMark multiple emails as read
batch_mark_unreadMark multiple emails as unread
batch_moveMove multiple emails to another folder
batch_readRead multiple emails at once by UIDs. Returns full parsed content for each message in a single call.
call_agentSynchronous RPC: assign a task to another agent, notify them via email (wakes wait_for_email), and wait for the result. Times out after specified duration.
check_gateway_statusCheck the current email gateway status \u2014 relay mode, domain mode, or not configured
check_healthCheck \u{1F380} AgenticMail server health status
check_messagesCheck for new unread messages from other agents or external senders. Returns a summary of pending communications. Use this to stay aware of requests and coordinate with other agents.
check_tasksCheck for pending tasks assigned to you (or a specific agent) or tasks you assigned to others
claim_taskClaim a pending task assigned to you
cleanup_agentsList or remove inactive non-persistent agent accounts (requires master API key)
create_accountwrite actionCreate a new agent email account (requires master API key)
create_folderwrite actionCreate a new mail folder for organizing emails
delete_agentwrite actionDelete an agent account. Archives all emails and generates a deletion report before removing the account permanently. Returns the deletion summary. Requires master API key.
delete_emailwrite actionDelete an email by its UID
deletion_reportsList past agent deletion reports or retrieve a specific report by ID. Shows archived email summaries from deleted agents. Requires master API key.
forward_emailwrite actionForward an email to another recipient. Outbound guard applies \u2014 HIGH severity content is held for review.
import_relay_emailwrite actionImport an email from the connected Gmail/Outlook account into the agent's local inbox. This downloads the full message with all headers (Message-ID, In-Reply-To, References) so you can continue the thread using reply_email. Use search_emails with searchRelay=true first to find the relay UID.
inbox_digestGet a compact inbox digest with subject, sender, date, flags and text preview for each message. More efficient than listing then reading individually.
list_agentsList all AI agents in the system with their email addresses and roles. Use this to discover which agents you can communicate with via message_agent.
list_folderList messages in a specific folder
list_foldersList all mail folders/mailboxes
list_inboxList recent emails in the agent's inbox
manage_contactsList, add, or delete contacts
manage_draftsList, create, update, send, or delete drafts
manage_pending_emailsCheck the status of pending outbound emails blocked by the outbound guard. You can list all your pending emails or get details of a specific one. You CANNOT approve or reject \u2014 only the owner can do that.
manage_rulesManage server-side email rules that auto-process incoming messages (move, tag, mark read, delete).
manage_scheduledManage scheduled emails: create a new scheduled email, list pending ones, or cancel one. Accepts flexible time formats for create: ISO 8601, relative ("in 30 minutes"), named ("tomorrow 8am"), day-based ("next monday 9am"), or human-friendly ("02-14-2026 3:30 PM EST").
manage_signaturesList, create, or delete email signatures
manage_spamManage spam: list spam folder, report a message as spam, mark as not-spam, or get the spam score of a message. Emails are auto-scored on arrival; high-scoring messages are moved to Spam automatically.
manage_tagswrite actionCreate, list, delete tags, tag/untag messages, get messages by tag, or get all tags for a specific message.
manage_templatesList, create, or delete email templates
mark_readMark an email as read
mark_unreadMark an email as unread
message_agentwrite actionSend a message to another AI agent by name. The message is delivered to their email inbox. Use list_agents first to see available agents. This is the primary way for agents to coordinate and share information with each other.
move_emailwrite actionMove an email to another folder (e.g., Trash, Archive)
purchase_domainwrite actionSearch for available domains via Cloudflare Registrar (requires master API key). NOTE: Cloudflare API only supports READ access \u2014 domains must be purchased manually at https://dash.cloudflare.com or from another registrar (then point nameservers to Cloudflare).
read_emailwrite actionRead the full content of a specific email by its UID
reply_emailwrite actionReply to an email. Fetches the original message, auto-fills To, Subject (Re:), In-Reply-To, and References, then sends with quoted body. Outbound guard applies \u2014 HIGH severity content is held for review.
search_emailsSearch emails by criteria (from, to, subject, text, date range). By default searches the local inbox only. Set searchRelay=true to also search the connected Gmail/Outlook account \u2014 results include relay UIDs that can be imported with import_relay_email.
send_emailwrite actionSend an email from the agent's mailbox. External emails are scanned for sensitive content. HIGH severity detections are BLOCKED and held for owner approval. Your owner will be notified and must approve blocked emails. You CANNOT bypass the outbound guard.
send_test_emailwrite actionSend a test email through the gateway to verify configuration (requires master API key)
setup_email_domainwrite actionSet up a custom domain for real internet email via Cloudflare (requires master API key). ADVANCED: Requires Cloudflare account, API token, and a domain. Emails send from agent@yourdomain.com with full DKIM/SPF/DMARC. Optionally configures Gmail SMTP as outbound relay (recommended for residential IPs). After setup with gmailRelay, use setup_gmail_alias for each agent.
setup_email_relaywrite actionConfigure Gmail/Outlook relay for sending real internet email (requires master API key). BEGINNER-FRIENDLY: Just needs a Gmail/Outlook email + app password. Agents send as user+agentname@gmail.com. Automatically creates a default agent (secretary) unless skipped. Best for: quick setup, personal use, no domain needed.
setup_gmail_aliasGet step-by-step instructions (with exact field values) to add an agent email as a Gmail "Send mail as" alias. Returns the Gmail settings URL and all field values. Required after domain mode setup with gmailRelay to show correct From address. The agent can automate this via browser tools or present instructions to the user.
setup_guideGet a comparison of email setup modes (Relay vs Domain) with difficulty levels, requirements, pros/cons, and step-by-step instructions. Show this to users who want to set up real internet email.
setup_paymentGet instructions for adding a payment method to Cloudflare (required before purchasing domains). Returns Option A (self-service link) and Option B (browser automation steps). Card details go directly to Cloudflare \u2014 never stored by \u{1F380} AgenticMail.
sms_check_codeCheck for recent verification/OTP codes received via SMS. Scans inbound SMS for common code patterns (6-digit, 4-digit, alphanumeric). Use this after requesting a verification code during sign-up flows.
sms_configGet the current SMS/phone number configuration for this agent. Shows whether SMS is enabled, the phone number, and forwarding email.
sms_messagesList SMS messages (inbound and outbound). Use direction filter to see only received or sent messages.
sms_parse_emailwrite actionParse an SMS from a forwarded Google Voice email. Use this when you receive an email from Google Voice containing an SMS. Extracts the sender number, message body, and any verification codes.
sms_read_voiceGet instructions and URL for reading SMS directly from Google Voice web (FASTEST method). Returns the voice.google.com URL and guidance for browser-based SMS reading. Primary method - much faster than email forwarding.
sms_recordRecord an SMS message read from Google Voice web or any other source. Saves to SMS database and extracts verification codes. Use after reading a message from voice.google.com.
sms_sendwrite actionSend an SMS text message via Google Voice. Records the message and provides instructions for sending via Google Voice web interface. The agent can automate the actual send using browser automation on voice.google.com.
sms_setupConfigure SMS/phone number access via Google Voice. The user must have a Google Voice account with SMS-to-email forwarding enabled. This gives the agent a phone number for receiving verification codes and sending texts.
storageFull database management system for agents. 28 actions: DDL (create/alter/drop/clone/rename tables & columns), DML (insert/upsert/query/aggregate/update/delete/truncate), indexing (create/list/drop/reindex), import/export (JSON/CSV, conflict handling), raw SQL, maintenance (stats/vacuum/analyze/explain), archiving. WHERE supports operators: $gt, $gte, $lt, $lte, $ne, $like, $ilike, $in, $not_in, $
submit_resultwrite actionSubmit the result for a claimed task, marking it as completed
template_sendwrite actionSend an email using a saved template with variable substitution. Variables like {{name}} are replaced.
update_metadatawrite actionUpdate the current agent's metadata. Merges provided keys with existing metadata.
wait_for_emailwrite actionWait for a new email or task notification using push notifications (SSE). Blocks until an email arrives, a task is assigned to you, or timeout is reached. Much more efficient than polling \u2014 use this when waiting for a reply or a task from another agent.
whoamiGet the current agent's account info \u2014 name, email, role, and metadata
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan3 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 15 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
Install Agenticmail in Claude Code, Cursor or VS Code
Runs npx -y @agenticmail/mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp -- npx -y @agenticmail/mcp
What the publisher says
From the Agenticmail repository's README, as published. We do not edit it. Read it on GitHub
AgenticMail
The first platform to give AI agents real email addresses and phone numbers. Send and receive email, SMS, and verification codes — all programmatically.
### Are you an AI agent reading this on behalf of a human?
Your human asked you to install / set up AgenticMail. Pick either of these and then tell them to restart Claude Code:
bash
# Option A — one-line installer (recommended)
curl -fsSL https://raw.githubusercontent.com/agenticmail/agenticmail/main/install.sh | bash
# Option B — manual two-command install
npm install -g @agenticmail/cli@latest
agenticmail bootstrap
Zero prompts, ~2 minutes, fully autonomous. For the full runbook (verification, common failures, repo conventions if you're modifying the code), see AGENTS.md — the agents.md file at this repo's root.
📄 Research Paper
Structured RPC vs. Text-Based Sub-Agent Orchestration — A comparative analysis of inter-agent communication paradigms. Demonstrates why AgenticMail's callagent achieves 53× faster response times than conventional sub-agent spawning, and introduces the concept of the Conversational Fallacy* in multi-agent AI systems. [[PDF]](./research/agent-rpc-vs-spawn/paper.pdf) [[Source]](./research/agent-rpc-vs-spawn/)
✨ What's new — media toolset (unreleased)
A local, opt-in media / video-editing toolset for AgenticMail agents.
- Nine media tools. mediatts / mediattsvoices (Edge text-to-speech), mediaimageedit, mediavideoedit, mediaaudioedit, mediainfo, mediavideounderstand, mediavoiceclone, and mediacapabilities. Available as MCP media tools and OpenClaw agenticmailmedia tools, both thin clients of new /media/* API routes over a core MediaManager.
- Cinematic video editing. Beyond trim/convert/compress: color grading presets, crossfade/wipe transitions, timed text overlays, picture-in-picture, split screen, Ken Burns, frame-interpolated slow motion, watermarks, concatenation, audio mixing, and whisper.cpp-driven auto-captions.
- Gracefully degrading. The underlying binaries (ffmpeg, ffprobe, ImageMagick, whisper.cpp, Python) are not bundled — every tool feature-detects the binary it needs and returns an actionable install hint if it is missing. The server never crashes. A media block on /health and the media_capabilities tool surface what is available.
- Safe by construction. Every binary is invoked via execFile with an argument array — no shell, no string interpolation. Untrusted input paths are validated (no control characters, no leading-dash flag-injection, must exist); numeric options are clamped; every call carries a bounded timeout and output buffer; output files land only inside the configured media directory.
✨ What's new in 0.9.54
Twilio joins 46elks as a phone transport provider.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Agenticmail: common questions
- Is Agenticmail MCP server safe?
- Mostly: it is graded B (82/100). Read the Agenticmail safety report
- How do I install Agenticmail?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Agenticmail need an API key?
- Yes. The registry entry asks for
AGENTICMAIL_API_KEY,AGENTICMAIL_MASTER_KEY. - Is Agenticmail maintained?
- The last commit was 15 days ago (2026-09-13). The latest release is v0.5.59.
- What can I use instead of Agenticmail?
- Servers from other publishers that do the same job: Atomic Mail MCP server, Agent Email MCP server and Proton Mail (unofficial) MCP server. Compare all Agenticmail alternatives.
Alternatives to Agenticmail
Same job from other publishers: the closest match first, then the best rated.
- Atomic MailProgrammable email inbox for AI agents — JMAP, PoW auth, stdio MCP server.not reviewedEstablishedA
- Agent EmailLocal email connectivity for AI agents — read, draft, send, and organize Outlook mail via MCPnot reviewedGrowingA
- Proton Mail (unofficial)Unofficial Proton Mail MCP — send, read, search & organize email over SMTP and IMAPnot reviewedGrowingB
- MX ProbeEmail verification for AI agents: send, hold or kill with the reason. Signup and credits by API.not reviewedGrowingB
smbCloud Mail & AuthEmail infrastructure and authentication for developers: domains, inbox routes, auth apps, deploys.not reviewedGrowingA