agent-intercom
A local mailbox so Claude Code, Codex CLI and Antigravity can message each other live
- Pricing
- Free
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.2.5
- Listing updated
- today
Similar MCP servers
About agent-intercom
agent-intercom is a free MCP server for developer tools. It runs locally on your machine and is started by your AI client.
agent-intercom solves a small but awkward problem: coding agents running side by side cannot talk to each other. It gives each one a named mailbox on disk and three tools to send, check and list peers. Ask Claude to have Codex review a diff and wait for the answer, and the request arrives in the open Codex session as a new turn rather than waiting to be polled.
Live delivery uses an optional background daemon that watches the mailbox and hands each message to the target session through whichever channel that CLI exposes: Claude Code's peer socket, the Codex app-server daemon, or Antigravity's agent API with a session hook. A message is claimed by rename so it is delivered once, and a failed push goes back to the inbox and retries after 30 seconds. Other MCP clients simply read with a blocking check.
The README is blunt about risk. The mailbox has no authentication, any process running as you can write to it, and agents treat messages as input to act on, so inbox text should be treated as untrusted. Push relies on undocumented internals that updates may break. A bridge script carries mail over SSH to remote machines.
Install
Run in a terminal
claude mcp add agent-intercom --env AGENT_NAME='<AGENT_NAME>' -- npx -y agent-intercomAdd to claude_desktop_config.json
{
"mcpServers": {
"agent-intercom": {
"command": "npx",
"args": [
"-y",
"agent-intercom"
],
"env": {
"AGENT_NAME": "<AGENT_NAME>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"agent-intercom": {
"command": "npx",
"args": [
"-y",
"agent-intercom"
],
"env": {
"AGENT_NAME": "<AGENT_NAME>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"agent-intercom": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"agent-intercom"
],
"env": {
"AGENT_NAME": "<AGENT_NAME>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"agent-intercom": {
"command": "npx",
"args": [
"-y",
"agent-intercom"
],
"env": {
"AGENT_NAME": "<AGENT_NAME>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"agent-intercom": {
"command": "npx",
"args": [
"-y",
"agent-intercom"
],
"env": {
"AGENT_NAME": "<AGENT_NAME>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
AGENT_NAMEThis agent's mailbox name, e.g. claude, codex or geminiRequiredAGENT_MAIL_DIRMailbox folder shared by all agents (default ~/.agent-mail)
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- mail_send
- Drop a message in another agent's inbox
- mail_check
- Read and consume your messages, optionally waiting up to 300 seconds
- mail_peers
- List known agents
What it does
- Three simple tools
- Send mail, check mail and list peers.
- Live push
- Messages land in open sessions without polling.
- Delivered once
- Rename-based claiming prevents duplicate delivery.
- Fail-safe fallback
- Failed pushes return to the inbox and retry.
- Multiple sessions
- Give each session its own mailbox name.
- Cross-machine bridge
- Move mail to remote hosts over SSH.
Good for
- Ask one agent to review another's diff and wait for the answer
- Hand off a task between Claude Code and Codex
- Coordinate agents running on a GPU server and a laptop
- Keep separate sessions of the same CLI talking to each other
Pricing
Free
Free to run locally
agent-intercom FAQ
Which agents are supported?
Claude Code, Codex CLI and Antigravity, with other MCP clients reading by polling.
Is it secure?
No authentication; any process running as you can write to the mailbox, so treat messages as untrusted.
How do I install it?
Run npx agent-intercom install, adding --push for live delivery.
Could push break?
Yes, it depends on undocumented internals of the CLIs, and failures fall back to the inbox.
Is agent-intercom free?
Yes. agent-intercom is free to use.
How do I add agent-intercom to Claude Code?
Run this command in your terminal: claude mcp add agent-intercom --env AGENT_NAME='<AGENT_NAME>' -- npx -y agent-intercom
What are the best alternatives to agent-intercom?
The closest alternatives to agent-intercom 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.


