Skip to content
MCP server

Intercom

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

Runs locally
Install
Pricing
Open source
Runs
Locally
Version
2.1.0
Listing updated
3 months ago

About Intercom

Intercom is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add intercom --env MY_ROLE='<MY_ROLE>' --env REMOTE_HOST='<REMOTE_HOST>' --env INTERCOM_SECRET='<INTERCOM_SECRET>' -- npx -y claude-intercom

Add to claude_desktop_config.json

{
  "mcpServers": {
    "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

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

Add to .vscode/mcp.json

{
  "servers": {
    "intercom": {
      "type": "stdio",
      "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

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MY_ROLELabel for this instance, e.g. backend or frontend. Appears in message tags so the other side knows who is talking.Required
  • REMOTE_HOSTAddress of the other machine as host:port. A Tailscale address is recommended over a public one.Required
  • INTERCOM_SECRETShared 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.Required
  • INTERCOM_PORTPort to listen on for incoming messages. Defaults to 8788.
  • INTERCOM_HOSTInterface 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_MSHow long an outbound POST may hang before giving up. Defaults to 10000.

Pricing

Open source

Intercom FAQ

Is Intercom free?

Yes. Intercom is open source, so you can use and self-host it for free.

How do I add Intercom to Claude Code?

Run this command in your terminal: claude mcp add intercom --env MY_ROLE='<MY_ROLE>' --env REMOTE_HOST='<REMOTE_HOST>' --env INTERCOM_SECRET='<INTERCOM_SECRET>' -- npx -y claude-intercom

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers