Commune MCP server
io.github.shanjai-raj/commune-mcp·v0.1.9·1 starsEmail and SMS MCP server for AI agents — 41 tools for inboxes, sending, search, and SMS.
1 stars21 downloads/wk
Reviews
Write oneNobody has reviewed Commune yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Commune tools (41, 12 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
assign_threadAssign a thread to an agent or user. Pass null/empty to unassign.
create_domainwrite actionCreate a new custom email domain.
create_inboxwrite actionCreate a new inbox for receiving emails.
credits_checkoutwrite actionCreate a Stripe checkout session to purchase a credit bundle.
delete_inboxwrite actionDelete an inbox.
get_attachment_urlGet a temporary download URL for an attachment.
get_credit_balanceGet current credit balance for your Commune account.
get_deliverability_statsGet email deliverability metrics: sent, delivered, bounced, complained, failed.
get_delivery_eventsGet delivery event log: sent, delivered, bounced, complained, failed.
get_domain_recordsGet the DNS records required to verify a domain.
get_phone_numberGet details for a single provisioned phone number.
get_sms_threadGet all messages in an SMS thread with a specific number.
get_suppressionsList suppressed email addresses (bounces, complaints, unsubscribes).
get_thread_messagesGet all messages in an email thread.
get_thread_metadataGet triage metadata for a thread: tags, status, and assignment.
list_available_phone_numbersList available phone numbers to purchase.
list_credit_bundlesList available credit bundles that can be purchased.
list_domainsList all email domains in your Commune account.
list_inboxesList inboxes.
list_phone_numbersList all provisioned phone numbers in your Commune account.
list_sms_conversationsList SMS conversation threads.
list_sms_suppressionsList phone numbers suppressed from receiving SMS (opted out via STOP keyword).
list_threadsList email threads (conversations) with pagination.
provision_phone_numberwrite actionPurchase/provision a phone number for SMS.
release_phone_numberRelease a provisioned phone number.
remove_extraction_schemawrite actionRemove structured extraction schema from an inbox.
remove_sms_suppressionwrite actionRemove a phone number from the SMS suppression list (re-enable SMS delivery).
search_smsSemantic search across SMS messages.
search_threadsSearch across email threads by subject or content.
send_emailwrite actionSend an email message.
send_smswrite actionSend an SMS message.
set_extraction_schemaSet structured extraction schema for an inbox.
set_phone_number_allow_listSet the allow list for a phone number (only these numbers can send SMS to it).
set_phone_number_block_listSet the block list for a phone number (these numbers are rejected).
set_phone_number_webhookConfigure a webhook for a phone number to receive SMS event notifications.
set_thread_statusSet the status of a thread for triage.
tag_threadAdd tags/labels to a thread. Tags are additive — existing tags are preserved.
untag_threadwrite actionRemove tags/labels from a thread.
update_phone_numberwrite actionUpdate a phone number's friendly name or auto-reply message.
upload_attachmentwrite actionUpload a file for use when sending emails.
verify_domainTrigger DNS verification for a domain.
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan8 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 94 days ago8/15
- Maintainer identityregistry namespace matches repository owner7/10
How Commune compares
Against every graded Email MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 71/100
- higher than 41% of 916 Email servers
- Tools
- 41
- the typical Email server has 7
- Tools that change things
- 29%
- typical: 25%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 493 Email servers
- Downloads a week
- 21
- more than 5% of 235 Email servers with a package
What its tools let an agent do: 23 read · 3 create · 10 change · 3 delete · 2 send or post
Install Commune in Claude Code, Cursor or VS Code
claude mcp add commune-mcp -- uvx commune-mcp
What the publisher says
From the Commune repository's README, as published. We do not edit it. Read it on GitHub
Email for Claude Desktop, Cursor & Windsurf
<!-- mcp-name: io.github.shanjai-raj/commune-mcp -->
Give Claude (or any MCP client) a real email inbox and SMS. Install in 30 seconds — no cloning required.
Your AI agent can:
- Read email — list threads, search by topic, get full message history
- Send email — reply in existing threads, compose fresh messages, attach files
- Manage inboxes — create programmatic inboxes, set up custom domains, triage with tags and status
- Track delivery — get delivery stats, suppression lists, bounce and complaint events
- Send and receive SMS — provision phone numbers, send messages, search SMS history
Works with Claude Desktop, Cursor, Windsurf, or any MCP client.
Install via Smithery
Commune is published on Smithery. One-line install for any supported client:
# Install Smithery CLI (once)
npm install -g @smithery/cli@latest
# Add Commune to your client
npx @smithery/cli install commune-dev/commune --client claude # Claude Desktop
npx @smithery/cli install commune-dev/commune --client cursor # Cursor
npx @smithery/cli install commune-dev/commune --client windsurf # Windsurf
npx @smithery/cli install commune-dev/commune --client vscode # VS Code
npx @smithery/cli install commune-dev/commune --client claude-code # Claude Code
npx @smithery/cli install commune-dev/commune --client cline # Cline
npx @smithery/cli install commune-dev/commune --client roo-cline # Roo Code
npx @smithery/cli install commune-dev/commune --client goose # GooseOr connect via the Smithery API for agent-to-agent use:
https://commune--commune-dev.run.toolsExample prompts
Once configured, you can give your AI assistant natural language instructions for email and SMS:
Reading email:
- "Check my support inbox for new emails"
- "Show me all unread threads in the billing inbox"
- "Find emails from customers asking about refunds this week"
- "Search for all threads about the payment issue from last month"
- "What's the full conversation history for thread conv_abc123?"
- "Show me all threads that haven't been replied to"
Sending email:
- "Reply to John's email saying we'll process his refund within 48 hours"
- "Send an email to alice@example.com with subject 'Meeting tomorrow' and tell her the meeting is moved to 3pm"
- "Reply to the last message in the support thread about the broken login, staying in thread"
- "Send a follow-up to all leads from last week who didn't respond"
Organizing and triaging:
- "Tag this thread as urgent and assign it to the billing team"
- "Mark all threads older than 30 days with no reply as closed"
- "Show me the deliverability stats for the past 7 days"
- "List all suppressed email addresses in the support inbox"
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Commune: common questions
- Is Commune MCP server safe?
- Mostly: it is graded B (71/100). Read the Commune safety report
- How do I install Commune?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Commune need an API key?
- Yes. The registry entry asks for
COMMUNE_API_KEY. - Is Commune maintained?
- The last commit was 131 days ago (2026-06-26). The latest release is v0.1.9.
- What can I use instead of Commune?
- Servers from other publishers that do the same job: Voidmail Agent Email MCP server, Pidgeon MCP server and Email Inbox API + Sending by Sendmux MCP server.
- How does Commune compare with other Email MCP servers?
- safety score 71/100 (higher than 41% of 916 Email servers); tools 41 (the typical Email server has 7); tools that change things 29% (typical: 25%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Commune
Same job from other publishers: the closest match first, then the best rated.
- Voidmail Agent EmailLocal MCP tools for server-readable agent inboxes and sending to owner-approved recipients.not reviewedGrowingA
PidgeonEmail inboxes for AI agents: addresses, threads, sending and replies.not reviewedGrowingA- Email Inbox API + Sending by SendmuxAI email inbox and sending tools with attachments, search, live events, and webhooks.not reviewedEstablishedA
- e2a — email for AI agentsAuthenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.not reviewedEstablishedA
- AgenticmailReal email and SMS for AI agents — send mail, receive verification codes, drive a real inbox.not reviewedEstablishedB