Intercom Mcp Server
About
MCP server for Intercom. Give AI agents native access to contacts, conversations, replies, assignments, and ticket resolution. Covers the 7 core Intercom API actions that handle 80% of agent workflows.
Explore
- Search contacts by email, name, or phone
- Create or update contacts
- Search conversations by status, contact, or assignee
- Reply to conversations as customer or internal note
- Close and resolve open conversations
- Assign conversations to an admin or team
- Add internal notes to a contact’s profile
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Intercom Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Node.js 18 or higher
- An Intercom account (free developer workspace works for testing)
---
git clone https://github.com/your-username/intercom-mcp-server.git
cd intercom-mcp-server
npm install
---
cp .env.example .env
Open .env and add your token:
INTERCOM_API_TOKEN=your_token_here
---
1. Push this repo to GitHub (private repo is fine)
2. Create a new project at railway.app
3. Connect your GitHub repo — Railway auto-detects Node.js
4. Add environment variable: INTERCOM_API_TOKEN = your_token
5. Deploy — Railway gives you a public URL
---
| Variable | Required | Description |
|---|---|---|
| INTERCOM_API_TOKEN | Yes | Your Intercom Bearer token |
---
search_contacts
Find a contact by email, name, or phone
create_or_update_contact
Create a new contact or update an existing one
search_conversations
Filter conversations by status, contact, or assignee
reply_to_conversation
Send a customer reply or internal note
close_conversation
Resolve and close an open conversation
assign_conversation
Route a conversation to an admin or team
create_contact_note
Add an internal audit note to a contact's profile
| Tool | What it does |
|---|---|
| search_contacts | Find a contact by email, name, or phone |
| create_or_update_contact | Create a new contact or update an existing one |
| search_conversations | Filter conversations by status, contact, or assignee |
| reply_to_conversation | Send a customer reply or internal note |
| close_conversation | Resolve and close an open conversation |
| assign_conversation | Route a conversation to an admin or team |
| create_contact_note | Add an internal audit note to a contact's profile |
---
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"intercom mcp server": {
"intercom": {
"command": "node",
"args": [
"/absolute/path/to/intercom-mcp-server/index.js"
],
"env": {
"INTERCOM_API_TOKEN": "your_intercom_api_token_here"
}
}
}
}
}McpServers
{
"intercom": {
"command": "node",
"args": [
"/absolute/path/to/intercom-mcp-server/index.js"
],
"env": {
"INTERCOM_API_TOKEN": "your_intercom_api_token_here"
}
}
}A hosted MCP server that gives AI agents full access to Intercom's core support workflows-search contacts, manage conversations, reply, assign, close tickets, and log notes.
Built on the Model Context Protocol using the official @modelcontextprotocol/sdk.
---
Tools
| Tool | What it does |
|---|---|
| search_contacts | Find a contact by email, name, or phone |
| create_or_update_contact | Create a new contact or update an existing one |
| search_conversations | Filter conversations by status, contact, or assignee |
| reply_to_conversation | Send a customer reply or internal note |
| close_conversation | Resolve and close an open conversation |
| assign_conversation | Route a conversation to an admin or team |
| create_contact_note | Add an internal audit note to a contact's profile |
---
Quickstart
1. Get your Intercom API token
1. Go to app.intercom.com
2. Navigate to Settings → Developer Hub → Your App → Authentication
3. Copy your Access Token
For testing, create a free developer workspace at app.intercom.com/developers — no paid plan required.
---
2. Clone and install
git clone https://github.com/your-username/intercom-mcp-server.git
cd intercom-mcp-server
npm install
---
3. Set your environment variable
cp .env.example .env
Open .env and add your token:
INTERCOM_API_TOKEN=your_token_here
---
4. Connect to Claude Desktop
Add this to your Claude Desktop config file:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"intercom": {
"command": "node",
"args": ["/absolute/path/to/intercom-mcp-server/index.js"],
"env": {
"INTERCOM_API_TOKEN": "your_token_here"
}
}
}
}
Restart Claude Desktop. You should see the Intercom tools available.
---
5. Test with the MCP Inspector
npx @modelcontextprotocol/inspector node index.js
This opens a browser UI at http://localhost:5173 where you can call each tool manually and inspect responses.
---
Deployment on Railway
1. Push this repo to GitHub (private repo is fine)
2. Create a new project at railway.app
3. Connect your GitHub repo — Railway auto-detects Node.js
4. Add environment variable: INTERCOM_API_TOKEN = your_token
5. Deploy — Railway gives you a public URL
---
Environment Variables
| Variable | Required | Description |
|---|---|---|
| INTERCOM_API_TOKEN | Yes | Your Intercom Bearer token |
---
Requirements
- Node.js 18 or higher
- An Intercom account (free developer workspace works for testing)
---
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
