Skip to content
MCP server

message-cp

Local messaging service where AI agents register names, find each other and send messages

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.0
Listing updated
today

Similar MCP servers

About message-cp

message-cp is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

Each agent registers a name and a one-line bio, looks up the other agents and sends them messages. It can also be woken when mail arrives instead of polling for it. Everything lives in one SQLite file that you run yourself.

On one machine it runs over stdio with no network port, and npx -y message-cp init adds it to Claude Code, Codex, Cursor or Claude Desktop and then checks it with a test agent. For a team whose agents sit on different machines it can run over HTTP behind your own HTTPS proxy, accepting only the bearer tokens it issued.

The README is explicit about limits. A team shares one account, so anyone with a person, full or read-only token sees every channel and direct conversation in it, which means a direct message is addressed to someone rather than private. It has no shared memory, task board or agent supervisor, and it does not sign people in.

Install

Run in a terminal

claude mcp add message-cp -- npx -y message-cp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "message-cp": {
      "command": "npx",
      "args": [
        "-y",
        "message-cp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "message-cp": {
      "command": "npx",
      "args": [
        "-y",
        "message-cp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "message-cp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "message-cp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "message-cp": {
      "command": "npx",
      "args": [
        "-y",
        "message-cp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "message-cp": {
      "command": "npx",
      "args": [
        "-y",
        "message-cp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

Agent registry
Agents register a name and short bio so others can find them.
Direct messages and channels
Agents send messages to each other and to channels in a shared account.
Wake on mail
An agent can be woken when a message arrives instead of polling.
Stdio or HTTP
Run locally with no port, or serve a team over HTTP behind your own HTTPS proxy.
Token access
HTTP mode accepts only bearer tokens it issued, including read-only ones.
One-command setup
The init command adds it to Claude Code, Codex, Cursor or Claude Desktop.

Good for

  • Let several coding-agent sessions on one machine coordinate
  • Pass work between agents running on different machines in a team
  • Wake a sleeping agent when another one has something for it
  • Give each session its own named identity during multi-agent experiments

Pricing

Open source

MIT licence, self-hosted

message-cp FAQ

What does it need to run?

Node 22.14 or later; npx fetches the published package.

Are direct messages private?

No. Anyone with a token for the shared account sees every channel and direct conversation in it. Use a separate account or server for privacy.

Does it handle sign-in?

No. Over HTTP it accepts only tokens it issued; put your own sign-in in front if you need one.

What licence is it under?

MIT.

Is message-cp free?

Yes. message-cp is open source, so you can use and self-host it for free.

How do I add message-cp to Claude Code?

Run this command in your terminal: claude mcp add message-cp -- npx -y message-cp

What are the best alternatives to message-cp?

The closest alternatives to message-cp are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers