Intercom Articles MCP Server

Intercom MCP Server

Intercom MCP server for Help Center content management and CS workflow automation.

Version

v0.6.0 - Added CS workflow tools (reply conversation, add note, close conversation, update ticket state)

Features

Articles

• ✅ get_article - Get a single article by ID
• ✅ list_articles - List articles with pagination
• ✅ search_articles - Search articles by keywords with highlighting support
• ✅ create_article - Create new articles with multilingual content
• ✅ update_article - Update existing articles with partial updates

Collections

• ✅ list_collections - List all Help Center collections
• ✅ get_collection - Get a single collection by ID
• ✅ update_collection - Update collection info and translations
• ✅ delete_collection - Delete a collection (permanent)

CS Workflow

• ✅ reply_conversation - Reply to a conversation as an admin
• ✅ add_conversation_note - Add an internal note to a conversation
• ✅ close_conversation - Close a conversation
• ✅ update_ticket_state - Update a ticket's state

Installation

1. Clone the repository:

git clone https://github.com/kaosensei/intercom-mcp.git
cd intercom-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

Configuration

Get Intercom Access Token

1. Go to Intercom Settings → Developers → Developer Hub
2. Create a new app or use existing one
3. Get an Access Token with Articles and Conversations read and write permissions

Environment Variables

Configure with Claude Code (Recommended)

If you're using Claude Code CLI, you can easily add the MCP server:

claude mcp add --transport stdio intercom-mcp \
  --env INTERCOM_ACCESS_TOKEN=<your_token> \
  --env INTERCOM_ADMIN_ID=<your_admin_id> \
  -- node /ABSOLUTE/PATH/TO/intercom-mcp/dist/index.js

Replace:

• <your_token> with your Intercom Access Token
• /ABSOLUTE/PATH/TO/ with your actual project path

To verify it's configured:

claude mcp list

Configure Claude Desktop Manually

Alternatively, edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "intercom-mcp": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/intercom-mcp/dist/index.js"
      ],
      "env": {
        "INTERCOM_ACCESS_TOKEN": "your_intercom_access_token_here",
        "INTERCOM_ADMIN_ID": "your_admin_id_here"
      }
    }
  }
}

Important:

• Replace /ABSOLUTE/PATH/TO/intercom-mcp with your actual project path
• Replace your_intercom_access_token_here with your actual token
• Replace your_admin_id_here with your Intercom admin ID (required for CS tools)

Restart Claude Desktop

Completely quit Claude Desktop and restart it.

Usage

Once configured, you can use these commands in Claude Desktop:

List Articles

List Intercom articles

or

Show me the first 20 Intercom articles

Get Article Details

Get Intercom article with ID 9876543

Search Articles

Search for Intercom articles about "subscription"

or

Search published articles containing "播客" with highlighted matches

or

Find articles with keyword "訂閱" in Chinese

Create Article

Create a new Intercom article titled "Getting Started Guide" with content "Welcome to our platform" by author ID 123456, save as draft

Update Article

Update article 9876543 and change its state to published

List Collections

List all Intercom Help Center collections

Get Collection

Get collection with ID 14608214

Update Collection

Update collection 14608214 and add Japanese translation

Delete Collection

Delete collection 16036040

Use Case: Translation Management

One of the key features of v0.4.0 is the ability to manage multilingual collections efficiently.

Add Missing Translations

You can easily add translations to collections that are missing certain languages:

Update collection 14608214 and add the missing Japanese translation: name "アカウント管理", description "アカウント設定を管理する"

Bulk Translation Updates

Check which collections are missing translations:

List all collections and show me which ones are missing Japanese translations

Then update them one by one or create a plan to update multiple collections.

Verify Translations

After updating, verify the changes:

Get collection 14608214 and show me all available translations

Tools Reference

`get_article`

Get a single art