Claude Intercom MCP Server

by muhammadtalhamtio.github.MuhammadTalhaMT/intercomv2.1.0

Relays messages between two Claude Code sessions on different machines using the Channels API

19Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained51d ago

Install Claude Intercom MCP server

claude mcp add claude-intercom -e MY_ROLE='<my-role>' -e REMOTE_HOST='<remote-host>' -e INTERCOM_SECRET='<intercom-secret>' -- npx -y claude-intercom

{
  "mcpServers": {
    "claude-intercom": {
      "command": "npx",
      "args": [
        "-y",
        "claude-intercom"
      ],
      "env": {
        "MY_ROLE": "<my-role>",
        "REMOTE_HOST": "<remote-host>",
        "INTERCOM_SECRET": "<intercom-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "claude-intercom": {
      "command": "npx",
      "args": [
        "-y",
        "claude-intercom"
      ],
      "env": {
        "MY_ROLE": "<my-role>",
        "REMOTE_HOST": "<remote-host>",
        "INTERCOM_SECRET": "<intercom-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "claude-intercom": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "claude-intercom"
      ],
      "env": {
        "MY_ROLE": "<my-role>",
        "REMOTE_HOST": "<remote-host>",
        "INTERCOM_SECRET": "<intercom-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "claude-intercom": {
      "command": "npx",
      "args": [
        "-y",
        "claude-intercom"
      ],
      "env": {
        "MY_ROLE": "<my-role>",
        "REMOTE_HOST": "<remote-host>",
        "INTERCOM_SECRET": "<intercom-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MY_ROLE	yes	—	Label for this instance, e.g. backend or frontend. Appears in message tags so the other side knows who is talking.
REMOTE_HOST	yes	—	Address of the other machine as host:port. A Tailscale address is recommended over a public one.
INTERCOM_SECRET	yes	yes	Shared secret authenticating messages between the two instances. Must match on both sides. There is no default: without it the intercom starts unpaired, binds no port, and refuses to send.
INTERCOM_PORT	—	—	Port to listen on for incoming messages. Defaults to 8788.
INTERCOM_HOST	—	—	Interface to bind the listener to. Defaults to 0.0.0.0. Set 127.0.0.1 when a tunnel fronts the intercom, so only the tunnel can connect.
INTERCOM_SEND_TIMEOUT_MS	—	—	How long an outbound POST may hang before giving up. Defaults to 10000.

Freshness

Maintained — last maintenance signal 51d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-19 · 51d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-19 · 51d ago · official registry · v2.1.0

FAQ

›How do I install the Claude Intercom MCP server in Claude Code?

Run: claude mcp add claude-intercom -e MY_ROLE='<my-role>' -e REMOTE_HOST='<remote-host>' -e INTERCOM_SECRET='<intercom-secret>' -- npx -y claude-intercom. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Claude Intercom require an API key?

Yes. It expects MY_ROLE, REMOTE_HOST, INTERCOM_SECRET, of which 1 is a secret.

›Can I use Claude Intercom as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Claude Intercom in the official MCP registry?

Yes, as io.github.MuhammadTalhaMT/intercom.