# agent-intercom

> agent-intercom is a free MCP server for developer tools. A local mailbox so Claude Code, Codex CLI and Antigravity can message each other live. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Linux
- **Repository:** https://github.com/iambashar/agent-intercom
- **MCP Registry name:** io.github.iambashar/agent-intercom
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add agent-intercom --env AGENT_NAME='<AGENT_NAME>' -- npx -y agent-intercom
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "agent-intercom": {
      "command": "npx",
      "args": [
        "-y",
        "agent-intercom"
      ],
      "env": {
        "AGENT_NAME": "<AGENT_NAME>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-intercom": {
      "command": "npx",
      "args": [
        "-y",
        "agent-intercom"
      ],
      "env": {
        "AGENT_NAME": "<AGENT_NAME>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "agent-intercom": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agent-intercom"
      ],
      "env": {
        "AGENT_NAME": "<AGENT_NAME>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-intercom": {
      "command": "npx",
      "args": [
        "-y",
        "agent-intercom"
      ],
      "env": {
        "AGENT_NAME": "<AGENT_NAME>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-intercom": {
      "command": "npx",
      "args": [
        "-y",
        "agent-intercom"
      ],
      "env": {
        "AGENT_NAME": "<AGENT_NAME>"
      }
    }
  }
}
```

## Tools

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

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

## 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/agent-intercom
