mcp
IntegrationCommunicationReal email and SMS for AI agents — send mail, receive verification codes, drive a real inbox.
This server has no hosted endpoint yet, so ahel can't serve it. You can still add it. It stays paused until ahel can serve it.
One link, every agent. Your own credentials, stored once.
Tools it gives your agents (101)
| Tool | What it does |
|---|---|
| send_email | Send an email from the agent's mailbox. The PRIMARY primitive for multi-agent coordination. |
| broadcast_email | Send the SAME email to N agents as N SEPARATE, ISOLATED emails — no CC, no shared thread. Each recipient sees ONLY their own address on the `To:` line and reads the message as a private 1:1 from you. |
| list_inbox | List recent emails in the agent's inbox |
| read_email | Read the full content of a specific email by its UID |
| delete_email | Delete an email by its UID |
| search_emails | Search emails by criteria (from, to, subject, text, date range). By default searches the local inbox only. |
| import_relay_email | Import an email from the connected Gmail/Outlook account into the agent's local inbox. |
| reply_email | Reply to an email. Fetches the original message, auto-fills To, Subject (Re:), In-Reply-To, and References, then sends with quoted body. |
| forward_email | Forward an email to another recipient. Outbound guard applies — HIGH severity content is held for review. |
| move_email | Move an email to another folder (e.g., Trash, Archive) |
| mark_unread | Mark an email as unread |
| mark_read | Mark an email as read |
| list_folders | List all mail folders/mailboxes |
| list_folder | List messages in a specific folder |
| batch_delete | Delete multiple emails by UIDs |
| batch_mark_read | Mark multiple emails as read |
| manage_contacts | List, add, or delete contacts |
| manage_drafts | List, create, update, send, or delete drafts. On send, you can pass `wake` to limit which local recipients get a host turn — same semantics as send_email. |
| manage_scheduled | Manage scheduled emails: create a new scheduled email, list pending ones, or cancel one. |
| create_folder | Create a new mail folder for organizing emails |
| manage_tags | Create, list, delete tags, tag/untag messages, get messages by tag, or get all tags for a specific message. |
| create_account | Create a new AgenticMail agent (email account + identity + API key + persona derived from role/metadata). Requires master API key. |
| setup_operator_email | Save the operator's notification email address for bridge-escalation alerts. When sub-agents mail a host bridge (e.g. |
| setup_email_relay | Configure 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. |
| setup_email_domain | Set up a custom domain for real internet email via Cloudflare (requires master API key). ADVANCED: Requires Cloudflare account, API token, and a domain. |
| setup_guide | Get a comparison of email setup modes (Relay vs Domain) AND the optional channels — realtime voice (OPENAI_API_KEY), phone call-control with a 46elks-vs-Twilio provider choice, and the Telegram... |
| setup_gmail_alias | Get 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. |
| setup_payment | Get instructions for adding a payment method to Cloudflare (required before purchasing domains). Returns Option A (self-service link) and Option B (browser automation steps). |
| purchase_domain | Search for available domains via Cloudflare Registrar (requires master API key). NOTE: Cloudflare API only supports READ access — domains must be purchased manually at https://dash.cloudflare.com or... |
| check_gateway_status | Check the current email gateway status — relay mode, domain mode, or not configured |
| send_test_email | Send a test email through the gateway to verify configuration (requires master API key) |
| list_agents | List all AI agents in the system with their email addresses and roles. Use this to discover which agents you can call via call_agent (sync RPC) or email via send_email / message_agent (async). |
| message_agent | Async fire-and-forget: deliver a message to another AI agent's inbox. They will process it on their own schedule (immediately if a dispatcher is attached, later otherwise) and may reply by email. |
| check_messages | Check 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. |
| delete_agent | Delete an agent account. Archives all emails and generates a deletion report before removing the account permanently. Returns the deletion summary. Requires master API key. |
| stop_agent | HARD-stop an agent mid-task WITHOUT deleting it. Sets the agent's `stopped` flag and (0.9.29+) immediately ABORTS any in-flight worker for that agent — the running SDK call is killed via... |
| resume_agent | Reverse a previous `stop_agent` call. Clears the `stopped` flag so the dispatcher resumes waking this agent on incoming mail and task events. |
| deletion_reports | List past agent deletion reports or retrieve a specific report by ID. Shows archived email summaries from deleted agents. Requires master API key. |
| manage_signatures | List, create, or delete email signatures |
| manage_templates | List, create, or delete email templates |
| batch_mark_unread | Mark multiple emails as unread |
| batch_move | Move multiple emails to another folder |
| whoami | Get the current agent's account info — name, email, role, and metadata |
| update_metadata | Update the current agent's metadata. Merges provided keys with existing metadata. |
| check_health | Check 🎀 AgenticMail server health status |
| wait_for_email | Block until a matching email (or task) lands in your inbox. Push-based (SSE) — far more efficient than polling. |
| batch_read | Read multiple emails at once by UIDs. Returns full parsed content for each message in a single call. |
| inbox_digest | Get a compact inbox digest with subject, sender, date, flags and text preview for each message. More efficient than listing then reading individually. |
| template_send | Send an email using a saved template with variable substitution. Variables like {{name}} are replaced. |
| manage_rules | Manage server-side email rules that auto-process incoming messages (move, tag, mark read, delete). |
| cleanup_agents | List or remove inactive non-persistent agent accounts (requires master API key) |
| save_thread_memory | Persist a one-paragraph memory of where THIS agent stands on the given thread. Called at the end of every wake — Claude Code reads it back into the next wake's prompt so the agent doesn't re-derive... |
| get_thread_id | Resolve the stable thread id for a message UID. Use this BEFORE calling save_thread_memory or when you want to inspect the cache for a thread. Pass the UID of any message on the thread (root or reply) |
| tail_worker | Tail the log of a running (or recently-finished) dispatcher worker. Use this when check_activity shows a worker has been running a long time or is marked stale, and you want to see what it is... |
| check_activity | Check which agents are currently being woken by the dispatcher. Use this when you sent mail to a teammate and want to know if they have actually started working, or to audit the live multi-agent... |
| check_tasks | Check for pending tasks assigned to you (or a specific agent) or tasks you assigned to others |
| claim_task | Claim a pending task assigned to you |
| submit_result | Submit the result for a claimed task, marking it as completed |
| call_agent | Synchronous RPC to delegate work to another AgenticMail agent. Pipeline: the task is queued in AgenticMail, the target agent processes it AS THEMSELVES (under their real identity, mailbox, persona... |
| manage_spam | Manage 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. |
Signals
- GitHub stars
- 211
- Forks
- 35
- Last commit
- Aug 2026
- Weekly downloads
- 175
- Tools captured
- 101
Advanced
- Delivery
- mcp MCP server → your ahel gateway (mcp.ahel.ai) → every connected AI client.
- Catalog kind
- mcp-server
- Gateway key
io-github-agenticmail-mcp- Source
- github.com/agenticmail/agenticmail