Home / MCP / MCP Intercom Server

MCP Intercom Server

Queries Intercom conversations and chats using MCP with date, state, and customer filters.

javascript

7stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "intercom": {
            "command": "node",
            "args": [
                "/path/to/mcp-intercom/dist/index.js"
            ],
            "env": {
                "INTERCOM_API_KEY": "your_api_key_here"
            }
        }
    }
}

The MCP Intercom Server lets you access and analyze your Intercom conversations from an MCP client. It provides read-only querying over conversations with useful filters so you can surface exactly the data you need for analysis, reporting, or building assistants that understand your customer conversations.

How to use

Start the Intercom MCP server, then connect your MCP client to query conversations. You can filter by date ranges, customer, or conversation state, and you receive rich results that include basic details, contact information, and conversation statistics. Use the server to power chat assistants, analytics, or workflows that need insight into your Intercom conversations.

How to install

Prerequisites: you need Node.js and npm installed on your machine. Verify installations with these commands:

node -v
npm -v

Clone the project, install dependencies, and prepare the environment:

git clone https://github.com/fabian1710/mcp-intercom.git
cd mcp-intercom
npm install
cp .env.example .env

Add your Intercom API key to the environment file. Open ".env" and set your key as shown:

INTERCOM_API_KEY=your_api_key_here

Build the server and start it for usage in your MCP ecosystem:

npm run build
npm start

Claude for Desktop configuration and usage

To enable Claude for Desktop to communicate with this MCP server, add the MCP configuration to Claude’s configuration file. The snippet below shows how to wire the Intercom MCP into Claude Desktop with the required environment variable.

{
  "mcpServers": {
    "intercom": {
      "command": "node",
      "args": ["/path/to/mcp-intercom/dist/index.js"],
      "env": {
        "INTERCOM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available tools

search-conversations

Queries Intercom conversations with optional filters: createdAt, updatedAt, sourceType, state, open, and read. Returns matching conversations along with related metadata.