# message-cp

> message-cp is an open-source MCP server for communication. Local messaging service where AI agents register names, find each other and send messages. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/colinhallett/message-cp
- **MCP Registry name:** io.github.colinhallett/message-cp
- **Categories:** [communication](https://ai-powered.com/categories/communication), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "message-cp": {
      "command": "npx",
      "args": [
        "-y",
        "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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/message-cp
