# Commune

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 115 installs
- Author: commune-dev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/commune-dev/commune
- Updated: 2026-02-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/commune

## What it 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.

## Requirements
- Remote server: `https://commune--commune-dev.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http commune https://commune--commune-dev.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add commune --url https://commune--commune-dev.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "commune": {
            "url": "https://commune--commune-dev.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "commune": {
            "type": "http",
            "url": "https://commune--commune-dev.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http commune https://commune--commune-dev.run.tools
```

## When to use it
- 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
- Create an inbox called `billing` and send a payment reminder to `client@example.com`.
- Find every thread about refunds and tag them `urgent`.
- Attach `report.pdf` from disk and email it to `team@example.com`.

## Similar
- [email-composer](https://affpapa.org/en/nevibecode/skills/email-composer.md) — skill · 1670 installs
- [incoming-request-advisor](https://affpapa.org/en/nevibecode/skills/incoming-request-advisor.md) — skill · 1400 installs
- [internal-email-composer](https://affpapa.org/en/nevibecode/skills/internal-email-composer.md) — skill · 345 installs
- [professional-communication](https://affpapa.org/en/nevibecode/skills/professional-communication.md) — skill · 104 installs
- [outlook-email](https://affpapa.org/en/nevibecode/plugins/outlook-email.md) — plugin · ★ 8052 repo stars
- [gmail](https://affpapa.org/en/nevibecode/plugins/gmail.md) — plugin · ★ 8052 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
