intercom-mcp-server

MCP server for the Intercom REST API (v2.11).

102 tools covering every Intercom resource:

Setup

The server has three modes, in priority order:

Option A: Proxy mode (no credentials needed)

If you already use the official Intercom MCP (mcp.intercom.com) via mcp-remote in Claude Code, this server will automatically proxy through that existing authenticated session. No tokens, no developer app required — just a regular Intercom workspace account.

Add both to ~/.claude.json:

{
  "mcpServers": {
    "intercom": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.intercom.com/mcp"]
    },
    "intercom-local": {
      "command": "node",
      "args": ["/path/to/intercom-mcp-server/dist/index.js"]
    }
  }
}

When intercom-local starts with no token set, it detects this and connects to mcp.intercom.com as a sub-process, reusing the mcp-remote session that is already authenticated. mcp-remote will prompt for browser login on first use.

Option B: Direct access token

If you have a workspace access token (from Intercom Settings → Developers → Access tokens):

{
  "mcpServers": {
    "intercom-local": {
      "command": "node",
      "args": ["/path/to/intercom-mcp-server/dist/index.js"],
      "env": {
        "INTERCOM_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

Option C: OAuth app

If you have an Intercom developer account and want to register your own OAuth app, set INTERCOM_CLIENT_ID and INTERCOM_CLIENT_SECRET, then call the auth_start tool. It opens a local callback server, redirects your browser through Intercom's OAuth consent screen, and stores the token at ~/.intercom-mcp/token.json.

Build from source

git clone <repo>
cd intercom-mcp-server
npm install   # also runs tsc

Tools reference

Auth (OAuth)

• auth_start — Begin OAuth login; returns a browser URL to open

• auth_status — Check if a token is stored and which source it came from

• auth_logout — Remove the stored token

Admins

• admin_identify — Get the current authenticated admin

• admin_list — List all admins

• admin_get — Get a specific admin

• admin_set_away — Set away mode for an admin

• admin_list_activity_logs — List admin activity logs

Articles

• article_list — List all articles

• article_create — Create an article

• article_get — Get an article

• article_update — Update an article

• article_delete — Delete an article

• article_search — Search articles by phrase

Companies

• company_list — List/filter companies

• company_create_or_update — Create or update a company

• company_get — Get a company by Intercom ID

• company_update — Update a company

• company_delete — Delete a company

• company_list_all — List all companies (paginated POST)

• company_scroll — Scroll through all companies

• company_list_contacts — List contacts for a company

• company_list_segments — List segments for a company

• attach_contact_to_company — Attach a contact to a company

• list_contact_companies — List companies for a contact

• detach_contact_from_company — Detach a contact from a company

Contacts

• contact_list — List all contacts

• contact_create — Create a contact

• contact_get — Get a contact

• contact_update — Update a contact

• contact_delete — Delete a contact

• contact_archive / contact_unarchive — Archive/unarchive a contact

• merge_contacts — Merge two contacts

• search_contacts — Search contacts with filters

• contact_list_notes / contact_create_note — Notes

• contact_list_tags / contact_attach_tag / contact_detach_tag — Tags

• contact_list_subscriptions / contact_attach_subscription / contact_detach_subscription — Subscriptions

Conversations

• conversation_list — List conversations

• conversation_create — Start a conversation

• conversation_get — Get a conversation

• conversation_update — Update a conversation

• search_conversations — Search conversations

• conversation_reply — Reply to a conversation

• conversation_manage — Close, open, snooze, or assign a conversation

• conversation_run_assignment_rules — Run assignment rules

• conversation_attach_contact / conversation_detach_contact — Manage contacts

• conversation_redact — Redact a part or source

• conversation_convert_to_ticket — Convert to a ticket

Data Attributes

• data_attribute_list — List data attributes

• data_attribute_create — Create a data attribute

• data_attribute_update — Update a data attribute

Data Events

• data_event_list — List events for a user

• data_event_create — Track an event

• data_event_summaries — Submit event summaries

Help Center

• help_center_list / help_center_get — Help centers

• collection_list / collection_create / collection_get / collection_update / collection_delete — Collections

Messages

• create_message — Send an email or in-app message

News

• news_list_items / news_create_item / news_get_item / news_update_item / news_delete_item — News items

• news_list_newsfeeds / news_get_newsfeed / news_list_newsfeed_items — Newsfeeds

Segments

• segment_list — List segments

• segment_get — Get a segment

• segment_list_for_contact — List segments for a contact

Tags

• tag_list / tag_get / tag_create_or_update / tag_delete — Tag CRUD

• tag_companies — Tag companies

• tag_conversation / tag_detach_conversation — Tag conversations

• tag_ticket / tag_detach_ticket — Tag tickets

Teams

• team_list — List teams

• team_get — Get a team

Tickets

• ticket_create / ticket_get / ticket_update / ticket_search / ticket_reply — Tickets

• ticket_type_list / ticket_type_create / ticket_type_get / ticket_type_update — Ticket types

• ticket_type_attribute_create / ticket_type_attribute_update — Ticket type attributes

Visitors

• visitor_get — Get a visitor

• visitor_update — Update a visitor

• visitor_convert — Convert a visitor to lead or user