intercom — Claude Code MCP server: messaging across machines
Connects Claude Code sessions running on separate computers so their agents can exchange project questions directly.
claude mcp add --env MY_ROLE=<MY_ROLE> --env REMOTE_HOST=<REMOTE_HOST> --env INTERCOM_SECRET=<INTERCOM_SECRET> --env INTERCOM_PORT=<INTERCOM_PORT> --env INTERCOM_HOST=<INTERCOM_HOST> --transport stdio intercom -- npx -y claude-intercomWhat intercom does
Run the same server on both computers. It accepts HTTP traffic and forwards incoming messages to the local Claude Code session through the Channels API. The agent can use send_message to reach the other session and check_message to inspect a message.
You need Bun, Claude Code v2.1.80 or later, HTTP connectivity between the computers, and a shared secret. Messages arrive only while both sides are running. Claude Code must be launched with --dangerously-load-development-channels for the experimental Channels capability. Delivery and response are separate states: a remote process accepting a message does not mean its agent has read it.
What it helps with
- ask a session on another computer to inspect an API schema
- compare implementation details across Claude Code sessions
- check whether the remote process accepted a message
- get an answer from an agent with access to a different codebase
Example prompts for the agent
- Ask the Claude Code session on my other computer to check its API endpoint names and reply.
- Send the remote session a question about the API schema using
send_message. - Use
check_messageto see whether the other session has replied.
How to install intercom
Platform CLI
claude mcp add --env MY_ROLE=<MY_ROLE> --env REMOTE_HOST=<REMOTE_HOST> --env INTERCOM_SECRET=<INTERCOM_SECRET> --env INTERCOM_PORT=<INTERCOM_PORT> --env INTERCOM_HOST=<INTERCOM_HOST> --transport stdio intercom -- npx -y claude-intercomReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
codex mcp add intercom --env MY_ROLE=<MY_ROLE> --env REMOTE_HOST=<REMOTE_HOST> --env INTERCOM_SECRET=<INTERCOM_SECRET> --env INTERCOM_PORT=<INTERCOM_PORT> --env INTERCOM_HOST=<INTERCOM_HOST> -- npx -y claude-intercomReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"mcpServers": {
"intercom": {
"command": "npx",
"args": [
"-y",
"claude-intercom"
],
"env": {
"MY_ROLE": "<MY_ROLE>",
"REMOTE_HOST": "<REMOTE_HOST>",
"INTERCOM_SECRET": "<INTERCOM_SECRET>",
"INTERCOM_PORT": "<INTERCOM_PORT>",
"INTERCOM_HOST": "<INTERCOM_HOST>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"servers": {
"intercom": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"claude-intercom"
],
"env": {
"MY_ROLE": "<MY_ROLE>",
"REMOTE_HOST": "<REMOTE_HOST>",
"INTERCOM_SECRET": "<INTERCOM_SECRET>",
"INTERCOM_PORT": "<INTERCOM_PORT>",
"INTERCOM_HOST": "<INTERCOM_HOST>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
gemini mcp add -e MY_ROLE=<MY_ROLE> -e REMOTE_HOST=<REMOTE_HOST> -e INTERCOM_SECRET=<INTERCOM_SECRET> -e INTERCOM_PORT=<INTERCOM_PORT> -e INTERCOM_HOST=<INTERCOM_HOST> intercom npx -y claude-intercomReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about intercom
How do I install intercom in Claude Code?
Run claude mcp add intercom -e MY_ROLE=<MY_ROLE> -e REMOTE_HOST=<REMOTE_HOST> -e INTERCOM_SECRET=<INTERCOM_SECRET> -- npx -y claude-intercom. Set up the server on the other computer with the same secret; Bun is required.
What does intercom do?
It connects Claude Code sessions on separate computers over HTTP. Agents can send messages and check their delivery or reply status.
What is required to connect the computers?
Both need Bun and Claude Code v2.1.80 or later, along with HTTP reachability and a shared secret. Messages are available while both sides are running.
