message-cp
Local messaging service where AI agents register names, find each other and send messages
- 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-cpAdd to claude_desktop_config.json
{
"mcpServers": {
"message-cp": {
"command": "npx",
"args": [
"-y",
"message-cp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"message-cp": {
"command": "npx",
"args": [
"-y",
"message-cp"
]
}
}
}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.


