Skip to navigation
IntegrationsSetup guidesSupport

Intercom

Look up customers, conversations, and help articles through Intercom's MCP server.

Connect Intercom’s hosted MCP server so your receptionist can recognize callers who are your customers, check on their open conversations, and answer questions from your Help Center articles.

Conversations can contain private details. Tell your receptionist, in its instructions or a procedure, to share conversation details only after confirming the caller is the contact, for example by matching their phone number or email.

Setup

1

Create a private app

In Intercom, open the Developer Hub and create a new app for your workspace. Open the app and go to Configure → Authentication, then copy the access token.

Check the app’s permissions include reading users, companies, and conversations, plus reading articles. Add writing conversations only if you want your receptionist to leave internal notes.

2

Add the MCP server

In Reception.ai, go to Integrations, select Add integration, and choose MCP Server.

FieldValue
NameIntercom
Server typeStreamable HTTP
Server URLThe URL for your workspace’s region, below
Secret TokenYour access token
Workspace regionServer URL
US (you sign in at app.intercom.com)https://mcp.intercom.com/mcp
EU (you sign in at app.eu.intercom.com)https://mcp.eu.intercom.com/mcp

Select Enable. Reception.ai sends the token as a bearer token and lists Intercom’s tools.

3

Assign tools

Open the Tools tab and assign these to the Client (receptionist):

  • search_contacts and get_contact: find the caller and their details.
  • search_conversations and get_conversation: check the status of the caller’s requests.
  • search_articles and get_article: answer questions from your Help Center.

Optionally, assign add_internal_note so your receptionist can add a summary of the call to the caller’s conversation. Notes are only visible to your team. Leave create_article and update_article unassigned.

4

Test it

Test your receptionist by calling from a number saved on a test contact and asking about an open conversation.

Limitations

Intercom’s MCP server doesn’t support workspaces hosted in Australia.

Troubleshooting

ProblemWhat to check
No tools are listedUse the Streamable HTTP server type and the URL for your workspace’s region.
A tool returns a permission errorAdd the missing permission to the app in the Developer Hub.
The receptionist can’t find a callerIntercom matches phone numbers as stored on the contact. Store numbers in one format.
You changed the tokenEdit the integration and use Rotate Secret Token (optional). The saved token is never shown again.