MCP Intercom Server

MCP server for Intercom chat integration

typescript

7

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

Searches Intercom conversations with optional filters such as creation date, update date, source type, and state to retrieve relevant conversations for analysis.