Connect your AI Agents to Intercom in minutes

Merge lets you securely connect your agents to Intercom and thousands of tools instantly

Available tools

list_articles

List help center articles

get_article

Get information about a specific article

create_article

Create a new help center article

update_article

Update an existing help center article

delete_article

Delete a help center article

list_collections

List help center collections

get_collection

Get information about a specific collection

create_collection

Create a new help center collection

update_collection

Update an existing help center collection

search_articles

Search for articles in the help center

list_companies

List companies in the workspace

get_company

Get information about a specific company

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11
Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}
Copy Code
Copied!

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }
Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}
Copy Code

FAQs on using Merge's Intercom  MCP server

FAQs on using Merge's Intercom  MCP server

What is an Intercom MCP server?

It's a server that exposes data and functionality from Intercom via tools. Your AI agents can use these tools to create articles, read chat messages, update company information, and more.

How can I use the Intercom MCP server?

Here are just a few use cases:

Customer support automation: Your agent can monitor conversations, tickets, and user events in Intercom and take action automatically. For example, when a conversation is tagged as “bug” and closed, your agent can create a linked issue in your bug tracker and update the customer with a follow-up message

Customer data enrichment and insights: Your agent can enrich Intercom user and company profiles using data from other systems. For instance, when a new user signs up and appears in Intercom, your agent can pull plan details from Stripe, account health from your data warehouse, and update custom attributes like ARR, lifecycle stage, or churn risk

Proactive messaging and lifecycle campaigns: Your agent can analyze Intercom events, tags, and attributes to trigger targeted messages. For example, when a user repeatedly views a pricing page or gets stuck in an onboarding step, your agent can automatically send a personalized in-app message or email with relevant help content

Cross-tool workflow orchestration: Your agent can use Intercom as a trigger point for broader workflows across your stack. For example, when a high-value customer opens an urgent conversation, your agent can alert Slack, assign the conversation to a senior teammate, create a task in your project management tool, and log the interaction in your CRM

What are popular tools for Intercom’s MCP server?

Here are some popular tools across data types:

Articles

  • <code class="blog_inline-code">list_articles</code>
  • <code class="blog_inline-code">get_article</code>
  • <code class="blog_inline-code">create_article</code>
  • <code class="blog_inline-code">update_article</code>

Conversations

  • <code class="blog_inline-code">open_conversation</code>
  • <code class="blog_inline-code">search_conversations</code>
  • <code class="blog_inline-code">reply_to_conversation</code>
  • <code class="blog_inline-code">close_conversation</code>

Contacts

  • <code class="blog_inline-code">get_contact</code>
  • <code class="blog_inline-code">create_contact</code>
  • <code class="blog_inline-code">update_contact</code>
  • <code class="blog_inline-code">delete_contact</code>

What makes Merge Agent Handler’s Intercom MCP server better than alternative Intercom MCP servers?

Here are a few of the top reasons:

  • Enterprise-grade security and DLP: Tool inputs and outputs are scanned by a Security Gateway with DLP rules that can block, redact, or mask sensitive data before it reaches the agent or third-party system. This protects against data misuse across Intercom interactions
  • Real-time observability and audit trails: Access fully-searchable logs that allow teams to audit, debug, and optimize agent behavior across all connected tools
  • Managed authentication and permissions: Merge handles credential storage, validation, and dynamic authentication flows so agents only act on behalf of properly authorized users. This includes guided user authentication flows and support for both shared and per-user authentication
  • Customizable and broad tool coverage: Merge's Intercom MCP server comes with dozens of pre-built tools, which can be easily modified using Connector Studio. You can also add your own over time, giving you flexibility to extend functionality as your needs evolve

Can I set custom security rules for Intercom tool calls?

Yes, you can add any number of security rules in a matter of clicks in Merge Agent Handler.

For example, you can:

  • Block credit card numbers in Intercom messages or conversation notes
  • Redact social security numbers from Intercom user attributes or customer data
  • Log when agents access conversations containing email addresses or phone numbers
  • Block your agents from sending Intercom messages that contain specific terms, like "confidential" or "internal only"

How can I start using Merge Agent Handler’s Intercom MCP server?

1. Create your Agent Handler account. Sign up for a free account here.

2. Create a new Tool Pack. Go to "Tool Packs" in the dashboard sidebar and click "Create New Tool Pack." You can give it a descriptive name (e.g., "Customer Support Automation Pack").

3. Add the Intercom connector. Select Intercom from the list of available connectors and add it to your Tool Pack.

4. Configure authentication type. Choose between individual authentication, which enables each user to provide their own Intercom credentials, or shared authentication, which uses organization-level credentials for all users.

5. Select specific tools. Choose which Intercom tools you want to make available to your agent, or enable all tools by default.

6. Register a User identity. Navigate to "Registered Users" in the sidebar and create a new registered user. This represents the identity that'll perform actions through your agent.

7. Save your Tool Pack. Once configured, save your Tool Pack settings.

8. Connect the Tool Pack to your agent. Use the MCP entry URL provided in your Tool Pack settings to associate it with your agent. Your agent will now have access to the Intercom tools you've configured.

Explore other MCP servers built and managed by Merge

airtable
Airtable
amazon_s3
Amazon S3
anaplan
Anaplan
apollo
Apollo
articulate
Articulate Reach 360
asana
Asana
bamboohr
BambooHR
basecamp
Basecamp
bitbucket
Bitbucket
box
Box
cms_coverage
CMS Coverage
calendly
Calendly
clickup
ClickUp
cloudflare
Cloudflare
confluence
Confluence
contentful
Contentful
databricks
Databricks
datadog
Datadog
docusign
DocuSign
dropbox
Dropbox
dynamics365
Dynamics 365 Sales
figma
Figma
firecrawl
Firecrawl
freshbooks
FreshBooks
freshdesk
Freshdesk
freshservice
Freshservice
front
Front
gamma
Gamma
github
GitHub
gitlab
GitLab
gmail
Gmail
gong
Gong
google_bigquery
Google BigQuery
google_calendar
Google Calendar
google_docs
Google Docs
google_drive
Google Drive
google_meet
Google Meet
google_sheets
Google Sheets
greenhouse
Greenhouse
hubspot
HubSpot
jira
Jira
jira_service_management
Jira Service Management
linear
Linear
linkedin
LinkedIn
make
Make
microsoft_teams
Microsoft Teams
miro
Miro
monday
Monday.com
npi_registry
NPI Registry
notion
Notion
onedrive
OneDrive
onenote
OneNote
outlook
Outlook
pipedrive
Pipedrive
pubmed
PubMed
pylon
Pylon
quickbooks_online
QuickBooks Online
ramp
Ramp
sapsf
SAP SuccessFactors
salesforce
Salesforce
sendgrid
SendGrid
sentry
Sentry
servicenow
ServiceNow
sharepoint
SharePoint
shopify
Shopify
slack
Slack
snowflake
Snowflake
straker
Straker
stripe
Stripe
teamwork
Teamwork.com
trello
Trello
visualping
VisualPing
weather
Weather
wikipedia
Wikipedia
workday
Workday
x
X
zendesk
Zendesk
zendesk_sell
Zendesk Sell
zohocrm
Zoho CRM
zohodesk
Zoho Desk
zoom
Zoom
zoominfo
ZoomInfo

Ready to try it out?

Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now