Files
simplex-chat/packages/simplex-chat-mcp
..

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.

The group of a Claude Code session in the SimpleX app: a prompt, Claude's answer, and its requests to run commands, which one tap approves

🏗️ 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, Claude account, model, goal, working subagents and recap.
  • A session's group shows each subagent and workflow as it works, and when it stalls.
  • 🏗️ 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.
  • Answer Claude's questions, plans and subagents' tool prompts in the chat, and see when Claude Code stops or waits in its terminal.
  • 🏗️ Code diffs, etc.

Start

You need Node.js 22 or later, Claude Code, and the SimpleX Chat app 7.1 or later.

  1. 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
    
  2. Start Claude Code with the SimpleX channel:

    claude --dangerously-load-development-channels plugin:simplex@simplex-chat
    

    Scan 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.

  3. 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 .git or .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