* plan: mcp-replies * plan: mcp-replies, one vocabulary with reactions * plan: mcp-replies, replyTo from callers, file name in quotes * plan: mcp-replies, itemSender stays private, quoted file names * plan: mcp-replies, Q1 decided: serve returns the new reply_to * plan: mcp-replies, quote line before the reply, as the user asked * plan: mcp-replies, quote of 200 characters, ellipsis when cut * plan: mcp-replies, one quote line of 200 characters with media type * plan: mcp-replies, blank lines before the numbered lists * mcp: tests of the quoted message of a reply * mcp: Claude gets the message a reply quotes * docs: line links of protocol types in the MCP architecture * mcp: quote lines end at every line break and keep emoji whole * mcp: spec links of the reply change cite the queue and push lines, labels equal their anchors * plan: mcp-replies, tests of the review fixes, test names as in the code, the closing-tag escape of Claude Code * mcp: quotes for Claude drop bidi controls
SimpleX MCP server
Your Claude Code can now chat on SimpleX.
SimpleX Network is the only messaging network without any user identifiers - no phone numbers, usernames, account IDs or even random IDs. Your agent needs no account, no platform controls its identity, and nobody, not even the servers, can see who it talks to. The app was downloaded more than 3M times, and over 600,000 people use it every month.
With this package, Claude Code can join channels and groups, talk to bots, and even receive your prompts via the SimpleX app. It asks you on your phone before it connects or sends - one tap to approve.
Run Claude Code from the app
You need Node.js 22 or later, Claude Code, and the SimpleX Chat app 7.1 or later.
-
Install the plugin in Claude Code:
/plugin marketplace add https://raw.githubusercontent.com/simplex-chat/simplex-chat/master/.claude-plugin/marketplace.json /plugin install simplex@simplex-chat -
Start Claude Code with the SimpleX channel:
claude --dangerously-load-development-channels plugin:simplex@simplex-chatIf you don't want to run SimpleX MCP as a channel, start
claudewithout the flag to use it as an MCP server. Read more.Scan the QR code with the SimpleX app and tap Join. The group "Claude Control" appears. At the first start the plugin downloads the SimpleX core library, so the QR code can take a minute. If you close Claude Code before then, the next start shows it.
On several machines or containers, set
SIMPLEX_MCP_MACHINEon each, for exampleSIMPLEX_MCP_MACHINE=laptop, to name its group "Claude Control - laptop". -
Each Claude Code session gets its own group, such as "1 · my-project". Join it from the invitation in "Claude Control".
-
Send prompts in the session's group, and Claude answers there. Reply to a message to show Claude which one you mean. Prompts you type in the terminal appear there too, and Claude Code's own prompts, such as a finished background task, appear as one line each. Before Claude acts in other chats or uses a tool such as Bash, it asks in the group, and one tap approves.
Safety
- Anyone in "Claude Control" can join your sessions as an admin, so only invite people you trust.
- In a session, admins and owners can prompt Claude and approve what it does. Other members can only prompt, and observers can only read.
- Claude Code doesn't run
!or/commands sent in the group. - Claude sends files to the group only if the group allows them.
- Claude has no SimpleX address, so nobody can contact it first.
Only Claude Code, for now
The agent is tested with Claude Code. Tell us which other apps and models you want to use in an issue, or contribute.
Reference
REFERENCE.md covers the plugin's options, recovery and security. It also explains shared settings for several machines or containers, and running the agent as an MCP server without the channel.
What comes next: Roadmap.
Own a part of SimpleX
Business is moving into messages, and AI agents follow: an agent can ask a company's agent in a chat instead of opening the company's website, and buy there too. These chats hold plans, purchases and accounts, so with AI everyone feels the need for private and secure communication.
SimpleX Chat, the company that builds SimpleX Network, is raising a community round on Wefunder: wefunder.com/simplex.chat
