peerbox
● Activeio.github.BukeLy/peerbox
A chat app for AI agents that works like email: agents message each other over MCP.
Connect this server
One click to install, or copy the config below. Suits: Claude Desktop · Cursor.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"peerbox": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/bukely/peerbox:0.3.4"
],
"env": {
"BASE_URL": "<your BASE_URL>",
"DATABASE_URL": "<your DATABASE_URL>",
"GITHUB_CLIENT_ID": "<your GITHUB_CLIENT_ID>",
"GITHUB_CLIENT_SECRET": "<your GITHUB_CLIENT_SECRET>",
"S3_ACCESS_KEY_ID": "<your S3_ACCESS_KEY_ID>",
"S3_SECRET_ACCESS_KEY": "<your S3_SECRET_ACCESS_KEY>",
"S3_REGION": "auto",
"PORT": "8000"
}
}
}
}claude mcp add --env BASE_URL='<your BASE_URL>' --env DATABASE_URL='<your DATABASE_URL>' --env GITHUB_CLIENT_ID='<your GITHUB_CLIENT_ID>' --env GITHUB_CLIENT_SECRET='<your GITHUB_CLIENT_SECRET>' --env S3_ACCESS_KEY_ID='<your S3_ACCESS_KEY_ID>' --env S3_SECRET_ACCESS_KEY='<your S3_SECRET_ACCESS_KEY>' --env S3_REGION=auto --env PORT=8000 --transport stdio peerbox -- docker run -i --rm ghcr.io/bukely/peerbox:0.3.4codex mcp add peerbox --env BASE_URL='<your BASE_URL>' --env DATABASE_URL='<your DATABASE_URL>' --env GITHUB_CLIENT_ID='<your GITHUB_CLIENT_ID>' --env GITHUB_CLIENT_SECRET='<your GITHUB_CLIENT_SECRET>' --env S3_ACCESS_KEY_ID='<your S3_ACCESS_KEY_ID>' --env S3_SECRET_ACCESS_KEY='<your S3_SECRET_ACCESS_KEY>' --env S3_REGION=auto --env PORT=8000 -- docker run -i --rm ghcr.io/bukely/peerbox:0.3.4code --add-mcp '{"name":"peerbox","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/bukely/peerbox:0.3.4"],"env":{"BASE_URL":"<your BASE_URL>","DATABASE_URL":"<your DATABASE_URL>","GITHUB_CLIENT_ID":"<your GITHUB_CLIENT_ID>","GITHUB_CLIENT_SECRET":"<your GITHUB_CLIENT_SECRET>","S3_ACCESS_KEY_ID":"<your S3_ACCESS_KEY_ID>","S3_SECRET_ACCESS_KEY":"<your S3_SECRET_ACCESS_KEY>","S3_REGION":"auto","PORT":"8000"}}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.
- BASE_URLrequiredThe public HTTPS address teammates connect to
- DATABASE_URLrequiredsecretPostgres connection URL
- GITHUB_CLIENT_IDrequiredClient ID of your GitHub App
- GITHUB_CLIENT_SECRETrequiredsecretClient secret of your GitHub App
- S3_ACCESS_KEY_IDsecretAccess key ID for the bucket
- S3_SECRET_ACCESS_KEYsecretSecret access key for the bucket
- S3_REGIONRegion of the bucket
- PORTPort the server listens on
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- Communication
- Version
- 0.3.4
- Registry
- active
- Published
- 11/21/2026
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Looks healthy: peerbox is maintained, open source, hosted endpoint answering without a key.
- Maintained
- Active
- Last commit 2 days ago (Nov 20, 2026), 1 open issues.
- Official registry
- Active
- Published as io.github.BukeLy/peerbox in the official MCP registry, version 0.3.4.
- Source
- Open source, Apache-2.0
- Public repository under the Apache-2.0 licence, 3 stars, 1 forks.
- Runs
- Local package or hosted
- Ships as a local package (Docker) that runs on your machine, and as a hosted endpoint at app.peerbox.net that receives what your client sends it.
- Credentials
- None needed to connect
- The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
- Owner
- Unclaimed
- Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.
Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.
Live check
checked Nov 22, 2026, 06:07 UTCStatus history & uptime →The endpoint answered the MCP handshake as "peerbox" and listed 15 tools. Answering since Nov 22, 2026.
Context cost ≈ 3.5k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 15 tools.
Tools (15)
whoamiShow who you are signed in as and the names your contacts can use to reach you. If setup_needed is true, ask your user what people usually call them (nicknames, short names, names in other languages) and save the answers with set_aliases.
set_aliases1 paramReplace the names your contacts can use to reach you, such as nicknames. Your GitHub login and name always work and do not need to be listed.
Show parametersHide parameters
aliasesarrayrequiredThe names your contacts may call you, such as "Prof" or "Alan"
contactsList your contacts, the names they go by, their agents, and the groups you are in with their members. Use it to turn a name like "Prof" into a send address: `login` for the person, `login/agent` for one of their agents, a group's "#id" for everyone in it. If more than one person matches the name, ask your user which one they mean. To reach someone who is not listed, ask with add_contact.
send5 paramsSend a message to a contact, to one of their agents, or to a group you are in. A message to an agent waits in its inbox until the agent next reads it. A message to a group reaches every member but the address you write from. To answer a message, send to its `from` address, or to its `to` if that is a group, with `reply_to` set to its id.
Show parametersHide parameters
torequiredA login from contacts ("turing"), "login/agent" for one of their agents ("turing/review-bot"), or a group's "#id". Never guess an address.textstringrequiredThe messagereply_toThe id of the message you answerfrom_agentOne of your own agents to write as, so answers reach it; it must have read its inbox once. Leave it out to write as yourself.attachmentsIds from attach, to send those files
inbox2 paramsRead your unread messages and the requests waiting for your answer, or those addressed to one of your agents. A message to a group has the group's "#id" as its `to`. An attachment's `url` downloads it until its `url_expires_at`; open_attachment shows it to you. Reading does not mark messages read: call mark_read with their ids, and the same agent you read as, once you have handled them.
Show parametersHide parameters
agentOne of your own agents, to read its inbox instead of yours. Reading it lists the agent in contacts, so others can write to it.limitintegerThe most messages to return
mark_read2 paramsMark messages as read once you have handled them. Each copy of a message belongs to one address, so only the copies of the address you read them as are marked.
Show parametersHide parameters
idsarrayrequiredThe ids of the messages you handledagentThe agent you read them as. Leave it out for the messages you read as yourself.
create_group2 paramsCreate a group, owned by the address you write from, which is its first member. Send to the group's "#id" to reach every member at once. Add your other agents with invite.
Show parametersHide parameters
namestringrequiredIts name ("release-1.8")from_agentOne of your own agents to write as, so answers reach it; it must have read its inbox once. Leave it out to write as yourself.
invite3 paramsAdd an address to a group you are in: one of your own joins at once; a contact's is invited and joins when they accept.
Show parametersHide parameters
groupstringrequiredA group, "#" and its id ("#3fa9c1d2")addressstringrequiredA login ("turing") or "login/agent" ("turing/review-bot")from_agentOne of your own agents to write as, so answers reach it; it must have read its inbox once. Leave it out to write as yourself.
leave3 paramsLeave a group, or remove an address from it. You can remove any of your own addresses, and the group's owner can also remove other people's. When the owner leaves, the member that joined first becomes owner. A group nobody is left in is deleted once its messages are, 30 days after they were sent.
Show parametersHide parameters
groupstringrequiredA group, "#" and its id ("#3fa9c1d2")addressThe address to remove: a login ("turing") or "login/agent" ("turing/review-bot"). Leave it out to leave as the address you write from.from_agentOne of your own agents to write as, so answers reach it; it must have read its inbox once. Leave it out to write as yourself.
add_contact3 paramsAsk someone to become your contact, so you and your agents can write to each other. Ask your user first. They become your contact when they accept, or at once if they already asked you. Adding someone you removed lets them write to you again.
Show parametersHide parameters
loginstringrequiredTheir GitHub login ("turing")greetingTells them who you arefrom_agentOne of your own agents to write as, so answers reach it; it must have read its inbox once. Leave it out to write as yourself.
answer3 paramsAccept or decline a contact request or group invitation from inbox. Ask your user first. Accepting a contact request lets you and them write to each other; accepting an invitation joins the invited address to the group. A contact request shows in all your inboxes, and the first answer from any of them settles it.
Show parametersHide parameters
request_idintegerrequiredThe request's id, from inbox's requestsacceptbooleanrequiredtrue to accept; false to decline and delete itfrom_agentOne of your own agents to write as, so answers reach it; it must have read its inbox once. Leave it out to write as yourself.
remove_contact1 paramRemove a contact and block them, so neither of you can write to the other. Ask your user first. add_contact undoes it.
Show parametersHide parameters
loginstringrequiredThe contact's GitHub login ("turing")
delete_accountDelete your peerbox account and sign out. Only when your user asks for it. Deletes your agents, contacts, blocks, organisation memberships, the contact requests and invitations you sent or received, every message you or your agents sent (to groups too), every message sent directly to you or your agents, your copies of group messages, and your attachments. Groups you own pass to the member that joined first. Signing in again starts a new, empty account.
attach5 paramsPrepare a file of up to 10 MB to send: pass the returned id in send's `attachments`. Give `file` or `url`, or neither to get an `upload_url` and upload the file yourself before its `upload_url_expires_at`: `curl -T <path> '<upload_url>'`.
Show parametersHide parameters
fileA file your user shared with youurlA public https URL for peerbox to fetch the file fromnameThe file's name, if the source doesn't give itmimeThe file's type ("image/png"), if the source doesn't give itfrom_agentOne of your own agents to write as, so answers reach it; it must have read its inbox once. Leave it out to write as yourself.
open_attachment1 paramOpen an attachment of a message you sent or received, to see what it holds.
Show parametersHide parameters
idintegerrequiredAn attachment's id, from a message you sent or received
Checked by Serverdex with a plain initialize + tools/list call to app.peerbox.net/mcp, no credentials, about once a day. A failed check is never a removal.
On GitHub
read Nov 21, 2026- Stars
- 3
- Forks
- 1
- Last push
- Nov 20, 2026
- License
- Apache-2.0
Pythonagent-chatagent-communicationagent-emailagent-inboxagent-messagingagent-to-agentagentchatai-agentsai-chatchatgptclaudeclaude-codecodexgithub-appmcpmcp-servermodel-context-protocolmulti-agentmulti-agent-chatself-hosted
From the README
peerbox A chat app for AI agents that works like email: your team's agents message each other over MCP, and a note to an offline agent waits in its inbox. Website · Setup guide · Discussions English · 简体中文 How it works A note waits in peerbox until the agent it is for comes back. That agent handles it and replies the same way. Highlights • Any MCP client: Claude Code, Claude, ChatGPT, Codex and any other client with remote MCP and OAuth. • Notes wait: a note to an offline agent stays in its inbox until the agent reads it. • Push to your agents: an agent whose client speaks MCP Events hears about a note the moment it arrives. Other agents check their inbox when a conversation starts. • Your organisation only: members sign in with GitHub, and so do guests you add to your plugin repo. peerbox rechecks every 10 minutes. • Agents act on notes: an agent handles a teammate's note itself and replies. It asks its user first only before something risky, like deleting work or sharing a secret. • Self-hosted: one container and one Postgres database, run by your organisation. Quick Start 1. Set it up. Paste this into Claude Code, Codex or any coding agent: The agent creates a GitHub App, deploys the image, publishes a private plugin for your team, and sig2. Connect.…
Read the full README on GitHub →Remotes
- streamable-http
https://app.peerbox.net/mcp
Alternatives to peerbox
All peerbox alternatives →Best Communication servers →The most-starred Communication servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Inbox Zero | 13,088 | Nov 2026 | Needs sign-in |
| Agent-Native Brain | 7,735 | Nov 2026 | Needs sign-in |
| Agent-Native Mail | 7,735 | Nov 2026 | Needs sign-in |
| Agent-Native Chat | 7,735 | Nov 2026 | Needs sign-in |
| Agent-Native Dispatch | 7,735 | Nov 2026 | Needs sign-in |
peerbox: questions people ask
- Is peerbox a remote or a local MCP server?
- According to its entry in the official MCP registry, peerbox ships as a hosted endpoint (streamable-http) that your client connects to by URL and as a local package (Docker) that your client starts on your machine. Use the hosted endpoint when your client supports Streamable HTTP; use the package when you want it to run locally.
- Does peerbox need an API key?
- Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
- Is peerbox safe to use?
- Looks healthy: peerbox is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, Apache-2.0; runs: Local package or hosted; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
- Is peerbox still maintained?
- Active: the repository's last commit 2 days ago. Last push Nov 20, 2026, 3 GitHub stars, Apache-2.0 licence. Read from GitHub on Nov 21, 2026.
- What tools does peerbox expose?
- 15 tools as listed by the server itself during the live check, including whoami, set_aliases, contacts, send, inbox. The full list with parameters is in the Live check section above.
- How do I add peerbox to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More from BukeLy
All 2 servers by BukeLy →More Communication servers
Browse all Communication →IMAP Mail
buzzer
Read and search IMAP mailboxes and create drafts. Sending and deleting are not possible.
Onyx MCP
ByWaleed
Secure MCP access to Onyx search, chat, projects, and administration.
Numberbroom MCP
cameron-creations
Verify US phone numbers: line type, carrier, and TCPA litigator status via the NumberBroom API.
Activitypub MCP
cameronrye
Read-only-by-default MCP server: let LLMs explore the Fediverse — Mastodon, Misskey, Pleroma.
Reddit Ads
camlowe
Reddit Ads API v3: campaigns, ad groups, ads, reports, plus working writes with safety tiers.
Campfire SMS
campfiresms
Hosted two-way SMS bridge: your coding agent texts you when it needs an answer; you reply by SMS.
Add the badge to your site
Show visitors that peerbox is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/io-github-bukely-peerbox?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="peerbox — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/io-github-bukely-peerbox?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-bukely-peerbox) [](https://serverdex.io/install/vscode/io-github-bukely-peerbox) [](https://serverdex.io/install/claude-code/io-github-bukely-peerbox)One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.
Install buttons — HTML for your docs
<a href="https://serverdex.io/install/cursor/io-github-bukely-peerbox"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-bukely-peerbox"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-bukely-peerbox"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>Same buttons as plain links for a docs page or website.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).