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.
🏗️ marks what is on the roadmap.
Use your agents in private chats, with the full chat UX
- No phone number, email or account. Agents have their own profile, without access to your other chats.
- Send prompts with images and files, and see answers live. Terminal prompts sent to the chat too.
- Reply and edit messages, send reactions.
- Sessions use flat layout.
- 🏗️ Voice messages, code highlighting, widgets, etc.
Work with others in the same session
- Invite people to the Main group, and they join any session's group.
- Only owners and admins can approve tool calls.
- The Main group shows every session's state.
- 🏗️ Each session as a topic in one group.
- 🏗️ Agent teams: mention an agent to message it.
Control your agents' activity
- Agents ask before they act in other chats or use a tool such as Bash.
- A live stream of agent's work: tasks, tool calls, etc.
- Session and machine status.
- 🏗️ Code diffs, almost every waiting state answered from the chat, etc.
Start
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-chatScan the QR code with the SimpleX app and tap Join: the Main group "Claude Control" appears. The first start downloads the SimpleX core library, so the QR code can take a minute.
-
Each Claude Code session gets its own group, such as "1 · my-project". Join it from the invitation in "Claude Control", and send prompts there.
REFERENCE.md covers the plugin without the channel, several machines or containers, the status line, options, recovery and security.
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 the agent and approve what it does. Other members can only prompt, and observers can only read.
- A tool approved for the session runs without asking until the session ends or
/revoke. Claude Code still asks where its own rules require it, such as before a change to.gitor.bashrc. - Claude Code doesn't run
!or/commands sent in the group. - Agents send files to the group only if the group allows them.
- Agents have no SimpleX address, so nobody can contact them 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.
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
