Intercom MCP server
officialIntercom runs its own hosted MCP server with separate endpoints for US and EU workspaces. It gives mostly read access to conversations, contacts, companies and help articles, can write articles and internal notes, and has extra tools for workspaces with Fin Operator.
What an agent can do
- → Search and read conversations
- → Look up contacts and companies
- → Search and read help articles
- → Create and update articles
- → Add internal notes
AU-hosted workspaces are not supported. Articles require the read and write articles permission, internal notes require the write conversations permission, and the Fin Operator tools require OAuth and can change the workspace's live configuration.
About the Intercom MCP server
Intercom runs its own hosted MCP server that gives AI tools authenticated access to workspace data: conversations, contacts, companies and Help Center articles. The server has one address for workspaces hosted in the US and one for workspaces hosted in the EU, and requests to the EU address are processed within the EU. Workspaces hosted in Australia are not supported.
Support and product teams use it to search conversations, read a full thread, look up what is known about a contact or a company, and find the right help article. The assistant can also write new articles, update existing ones and add an internal note to a conversation. If the workspace has Fin Operator, the assistant can hand tasks to it as well.
Most of it is reading. Of the fourteen core tools, three write: create an article, update an article and add an internal note. The note is visible only to teammates, and the server cannot send replies that the customer sees. Access follows the permissions of the person who authorised the connection, and notes are written in that person's name. Intercom's normal API rate limits apply.
Things to ask
- Which conversations in the last week are about billing problems?
- Summarise the conversation with the customer at Acme and what we have promised them.
- What do we know about the company Acme: plan, number of users and latest contact?
- Find the help article on exporting data and update it with the new menu option.
- Add an internal note to the conversation saying the bug has been reported to the developers.
Tools the server exposes
- search
- fetch
- search_conversations
- get_conversation
- search_contacts
- get_contact
- list_companies
- get_company
- list_articles
- search_articles
- get_article
- create_article
- update_article
- add_internal_note
- send_operator_message
- get_operator_response
- get_proposal_details
- apply_proposals
- reject_proposals
How to connect Intercom
- Check where your workspace is hosted. If you sign in at app.intercom.com, use https://mcp.intercom.com/mcp, and at app.eu.intercom.com use https://mcp.eu.intercom.com/mcp. The wrong region gives an error after you choose Allow.
- In Claude, US workspaces add Intercom from the connectors directory. EU workspaces add a custom connector with the EU URL. On Claude Team and Enterprise an owner does this under the organisation settings.
- In Claude Code, Cursor, VS Code, Windsurf and OpenAI, add the URL following each tool's own guide, or through npx mcp-remote in a JSON configuration.
- Approve on Intercom's consent page within 15 minutes and then on Intercom's normal authorisation screen. Check the address you are being redirected to before you choose Allow.
- If a tool answers with a 401 error, the connection is older than a newly added permission. Disconnect and connect again.
Part of these packages
Intercom is part of these Walma packages.
Questions about Intercom MCP
Is the Intercom MCP server free, and which plans are required?+
Intercom's documentation states neither a price nor which plan the MCP server requires. The only thing that explicitly costs is the send_operator_message tool, which uses Operator credits. The Fin Operator tools are only available if the workspace has Fin Operator and the connection was made with OAuth. Ask Intercom whether your plan is covered.
What is the Intercom MCP server URL?+
For workspaces hosted in the US: https://mcp.intercom.com/mcp. For workspaces hosted in the EU: https://mcp.eu.intercom.com/mcp. Both use Streamable HTTP, which Intercom recommends. The older addresses ending in /sse still exist but are deprecated. Workspaces hosted in Australia have no address.
How does sign-in work?+
Intercom recommends OAuth: you are sent to an Intercom MCP consent page, choose Allow and then approve on Intercom's authorisation screen. The consent page is valid for 15 minutes. The alternative is an API token sent as a bearer token, but then the Fin Operator tools are missing. Custom clients with a callback address other than localhost must be approved by Intercom support.
Is the Intercom MCP server read-only?+
For the most part. Eleven of the fourteen core tools only read. Three write: create_article, update_article and add_internal_note. With Fin Operator there are additional tools that can send tasks to Operator and apply proposals that change the workspace's live configuration. Which tools work depends on the permissions the connection has been granted.
Which AI assistants does the Intercom MCP server work with?+
Intercom points to guides for Claude Desktop, Claude Code, OpenAI, Cursor, Windsurf and VS Code, and also names ChatGPT on its integration page. Claude has a ready-made Intercom connector for US workspaces, while EU workspaces add a custom connector with the EU URL. Other clients can connect through mcp-remote.
Does data stay in the EU with the Intercom MCP server?+
Intercom states that requests to the EU address are processed within the EU, in line with its Regional Data Hosting commitments. That covers the path between the AI client and Intercom. Where the AI assistant itself processes the answers is decided by that provider, not by Intercom. Workspaces hosted in Australia are not supported at all.
Can the AI reply to customers in Intercom through MCP?+
No. The add_internal_note tool only adds notes that teammates see and cannot send a reply to the customer. It never changes the assignee, but a note on a snoozed conversation assigned to someone else reopens it. The note is attributed to the person who authorised the connection, and ticket IDs are not supported.
Missing a connection?
We build and review MCP servers for teams that need them, and run them behind the same policy and log as the rest of the gateway.