▌BestMCPTools.org
Intercom MCP logo

Intercom MCP

Intercom's hosted MCP server for conversations, contacts, companies and articles

CommunicationIncluded with an Intercom workspace (paid per seat plus usage)Claude CodeClaude DesktopClaude.aiChatGPTCursorVS CodeWindsurfEasy

Last verified: October 8, 2026

Own Intercom MCP? Boost it to the top.✦ Upgrade to Featured

How to Install Intercom MCP

$claude mcp add --transport http intercom https://mcp.intercom.com/mcp

Compatible with: Claude Code, Claude Desktop, Claude.ai, ChatGPT, Cursor, VS Code, Windsurf.

Setup by client

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "intercom-mcp": {
      "url": "https://mcp.intercom.com/mcp"
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "intercom-mcp": {
      "type": "http",
      "url": "https://mcp.intercom.com/mcp"
    }
  }
}

Claude Code (terminal)

claude mcp add --transport http intercom-mcp https://mcp.intercom.com/mcp

Add any API keys or environment variables the server's README lists.

About Intercom MCP

Intercom MCP is the Model Context Protocol server that Intercom hosts for its own customers. It is a remote server at https://mcp.intercom.com/mcp (US) or https://mcp.eu.intercom.com/mcp (EU), documented on Intercom's developer hub, and it lets Claude, ChatGPT, Cursor, VS Code and other MCP clients search and read your conversations, contacts and companies, work with Help Center articles, and add internal notes to conversations. There is nothing to install from npm: Intercom does not publish an @intercom/mcp-server package.

Which Intercom MCP this page covers. Intercom runs a second, separate MCP server, the Fin Agent API MCP server at https://api.intercom.io/fin/mcp. That one lets an outside agent call Fin, Intercom's AI agent, to answer questions and run Fin procedures, and it authenticates with a Fin Agent API key. This page covers the workspace data server on mcp.intercom.com.

Quick facts (as of October 8, 2026)

Intercom MCP
MakerIntercom
TypeRemote, hosted by Intercom
URL (US)https://mcp.intercom.com/mcp (Streamable HTTP, recommended); /sse is legacy and deprecated
URL (EU)https://mcp.eu.intercom.com/mcp; /sse is legacy and deprecated
RegionsUS and EU hosted workspaces. AU hosted workspaces are not supported yet
AuthenticationOAuth in the browser (recommended) or an Intercom API token sent as a Bearer header
Tools14, as listed in the developer docs
AccessMostly read. Writes: create and update Help Center articles, add internal notes to conversations
Source codeNot published. The intercom/intercom-mcp-server GitHub repo holds a README and logos only
PriceNo separate MCP fee published. You need an Intercom workspace; plans start at $29 per seat per month (annual billing)
Official docsdevelopers.intercom.com/docs/guides/mcp

Tools

Our count from the developer docs page is 14 tools, which matches the "14 tools" the page itself states.

ToolWhat it doesReads or writes
searchUniversal search over conversations or contacts with a query syntax, such as object_type:conversations state:open source_type:emailRead
fetchFull details for a conversation, contact or company using an ID from searchRead
search_conversationsSearch conversations by IDs, source type, author, state, team or admin assignee, and timing statisticsRead
get_conversationOne conversation with all its parts and metadataRead
search_contactsSearch contacts by ID, name, email, phone, custom attributes or email domainRead
get_contactOne contact with custom attributes, location and activity timestampsRead
list_companiesList companies, filtered by name, company_id, tag or segmentRead
get_companyOne company with custom attributes, segments and tagsRead
list_articlesList all Help Center articlesRead
search_articlesSearch Help Center articles by phrase, state or Help Center IDRead
get_articleOne article with its full HTML bodyRead
create_articleCreate a Help Center article (draft by default)Write
update_articleUpdate an article's title, body, state, author or parentWrite
add_internal_noteAdd a teammate-only note to a conversationWrite

Search tools return up to 150 results per page (5 by default) and use a starting_after cursor. list_companies and list_articles use page numbers instead.

Setup

Pick the URL for your workspace's region first. Intercom's docs say app.intercom.com means a US hosted workspace and app.eu.intercom.com means EU hosted.

Claude Code

Claude Code's documented pattern for a remote server is claude mcp add --transport http <name> <url>:

claude mcp add --transport http intercom https://mcp.intercom.com/mcp

Use https://mcp.eu.intercom.com/mcp for an EU workspace. Then run /mcp inside Claude Code and choose the server to complete the OAuth sign-in in your browser.

Claude.ai

Intercom's docs say the Intercom connector in Claude's directory connects to US hosted workspaces. For an EU workspace, go to Customize, Connectors, Add, Add custom connector, and enter https://mcp.eu.intercom.com/mcp. On Claude Team or Enterprise, an organization Owner adds it under Organization settings, Connectors.

Clients that use a JSON config (Claude Desktop and others)

Intercom's generic template runs the mcp-remote bridge with npx:

{
  "mcpServers": {
    "intercom": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.intercom.com/mcp"]
    }
  }
}

For token authentication, Intercom's template adds "--header", "Authorization:${AUTH_HEADER}" to args and sets AUTH_HEADER to Bearer YOUR_INTERCOM_API_TOKEN in an env block. Intercom says these are templates and points you to each client's own MCP docs (Claude Desktop, Claude Code, OpenAI, Cursor, Windsurf and VS Code) for exact steps.

To check the connection, Intercom suggests npx @modelcontextprotocol/inspector with the Streamable HTTP transport and your region's URL.

Authentication and permissions

OAuth is the recommended route. Your browser shows two screens: an Intercom MCP consent page that names the application asking for access, lists what it can do and shows the address it redirects to, and then Intercom's own authorization screen. Intercom notes that the application name on the consent page is supplied by the application and not verified, so check the redirect address before you choose Allow. The consent page expires after 15 minutes.

The server needs these Intercom permissions:

  • Read and list users and companies
  • Read conversations
  • Write conversations, for add_internal_note
  • Read and write articles, for the five article tools

With Bearer token authentication, your token must include those scopes. Notes are attributed to the admin who authorized the connection, and cannot be set per call.

If you build your own MCP client, the server supports Dynamic Client Registration, but every OAuth redirect URI is checked against an allowlist. Localhost callbacks are allowed on any port; anything else needs an entry from Intercom Customer Support.

Limitations and things to watch

  • It is not read-only. An agent can create and update public Help Center articles and add notes to conversations. Keep tool approval on in your client, especially for update_article.
  • A note can reopen a conversation. Intercom's docs say a note on a snoozed conversation assigned to someone other than the authorizing admin will unsnooze it.
  • No customer-facing replies. add_internal_note cannot send anything to the customer, and no tool listed sends messages.
  • Tickets are not supported by the note tool. Ticket IDs return an authorization error.
  • Wrong region fails late. Using the US URL with an EU workspace leads to a "We're having technical difficulties" error after you choose Allow.
  • AU workspaces cannot use it yet.
  • Older connections may lack the write scope. Intercom says a 401 on add_internal_note usually means you should disconnect and reconnect to grant Write conversations.
  • Intercom API rate limits apply.
  • Official pages disagree. Intercom's integrations page and the GitHub README still say US only, and the README lists 6 tools. The developer docs, read on October 8, 2026, are the most current source.

Pros and cons

Pros

  • Official and hosted by Intercom, with nothing to install for clients that support remote servers.
  • OAuth sign-in with a consent page that shows which app gets access.
  • Covers conversations, contacts, companies and Help Center articles in one server.
  • EU endpoint processes requests within the EU.
  • Write access is narrow: articles and internal notes only.

Cons

  • No source code published, so you cannot audit or self-host it.
  • Write tools mean it is not a safe "read only" connection by default.
  • No AU region.
  • No tools for tickets, tags, admins or sending replies in the documented list.
  • Some official pages are out of date.

Who it is for

A good fit if:

  • Your support team runs on Intercom and you want an assistant to search conversations, summarize a customer's history or look for recurring themes.
  • You maintain a Help Center and want an agent to draft or update articles for review.
  • You want to leave internal notes on conversations from your AI client.

Not the right tool if:

  • You want an outside agent to answer customers using Fin. That is the Fin Agent API MCP server.
  • Your workspace is AU hosted.
  • Your helpdesk is Zendesk. See the Zendesk MCP server instead, or the HubSpot MCP server if your support data lives in HubSpot.

What we could not verify

  • Plan requirements. The developer docs do not say which Intercom plans can use the MCP server.
  • Rate limits specific to the MCP server. The docs only say Intercom API limits apply.
  • Whether the Claude.ai directory connector exposes all 14 tools.
  • A license. There is no published source code and no license file.
  • How the server behaves in practice. We did not run it.

How this page was put together

We read Intercom's MCP developer guide, the Intercom MCP Server integration page, the Fin Agent API MCP Server help article, the Intercom pricing page, the intercom/intercom-mcp-server GitHub repository, the npm registry and Claude Code's MCP docs on October 8, 2026. We did not run the server.

Sources

Pricing

Included with an Intercom workspace (paid per seat plus usage): from No separate MCP fee published; Intercom plans from $29 per seat/month billed annually (as of October 2026)

Our Take on Intercom MCP

A sensible first connection for support teams on Intercom who want an assistant to search conversation history, summarize customers or draft Help Center articles. It is hosted and official, with OAuth and an EU endpoint. It is not read-only: agents can edit public articles and add notes that may reopen snoozed conversations, so keep tool approval on. AU workspaces cannot use it yet.

Alternatives to Intercom MCP

Zendesk MCPCustomer Support

Read tickets and draft replies from AI agents

View Zendesk MCP →
HubSpot MCPAPIs & Data

Connects AI tools to your HubSpot CRM and content

View HubSpot MCP →

Frequently Asked Questions

Tags