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.
Details
- Author
- ShackletonAnalytics
- Downloads
- 217
- Categories
- Search
Jump to
- 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
Get an Intercom API token from your developer workspace, clone the repository, install dependencies with npm install, set the INTERCOM_API_TOKEN environment variable, then connect the server to Claude Desktop via its config file or test it with the MCP Inspector. Deployment on Railway is also supported.
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"
}
}
}Intercom MCP Server
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.
