Commune — Claude Code MCP server: email and phone for agents
Commune — an MCP server that gives an agent its own email address and phone number. The agent sends mail, reads replies, and manages threads through the server's tools.
no license 115 installs updated 2026-02-28
claude mcp add --transport http commune https://commune--commune-dev.run.toolsWhat Commune does
Commune turns an agent into a real correspondent. It can register a domain, create inboxes, send email with attachments, and read incoming messages. The server exposes around twenty tools: send_email, list_threads, create_inbox, plus delivery metrics and suppression lists.
Conversations appear as threads with subject, message count, and last activity. The agent can search by subject or body, add tags, change status, and assign a thread to itself or another agent. Attachments work in two steps: upload the file as base64 through upload_attachment, then pass the returned ID to send_email.
Using your own domain means adding MX, TXT, and CNAME records at the registrar. Call get_domain_records to see them, then verify_domain after they propagate. If you skip the domain, Commune assigns one automatically and no DNS setup is needed. The server runs at https://commune--commune-dev.run.tools and requires a Commune account.
What it helps with
- send a message from the agent's own address
- create an inbox for receiving replies
- search threads by subject or message text
- tag and set status on conversations
- check bounce and complaint rates per inbox
Example prompts for the agent
- Create an inbox called
billingand send a payment reminder to[email protected]. - Find every thread about refunds and tag them
urgent. - Attach
report.pdffrom disk and email it to[email protected].
How to install Commune
Platform CLI: remote server
claude mcp add --transport http commune https://commune--commune-dev.run.toolsPlatform CLI: remote server
codex mcp add commune --url https://commune--commune-dev.run.toolsConfig file
{
"mcpServers": {
"commune": {
"url": "https://commune--commune-dev.run.tools"
}
}
}Config file
{
"servers": {
"commune": {
"type": "http",
"url": "https://commune--commune-dev.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http commune https://commune--commune-dev.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Commune
How do I install Commune in Claude Code?
Run claude mcp add --transport http commune https://commune--commune-dev.run.tools. The server's tools will be available in your Claude Code session.
What does Commune do?
It provides email infrastructure for an agent: domains, inboxes, sending and receiving mail, attachments, thread search, and delivery statistics.
Do I need my own domain?
No. If you create an inbox without a domain_id, Commune picks an available domain and DNS setup is skipped. A custom domain requires adding DNS records and verifying them.