Merge Unified's Intercom integration Merge Agent Handler's Intercom MCP server

Connect your AI Agents to Intercom in minutes

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

Start building for free

Read docs

Intercom

Learn more about Merge Agent Handler

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

create_company

Create a new company

update_company

Update an existing company

delete_company

Delete a company

list_company_contacts

List contacts belonging to a company

attach_contact_to_company

Attach a contact to a company

detach_contact_from_company

Detach a contact from a company

list_contacts

List contacts in the workspace

get_contact

Get information about a specific contact

create_contact

Create a new contact

update_contact

Update an existing contact

delete_contact

Delete a contact

search_contacts

Search contacts using filters

list_conversations

List conversations (also known as tickets) in the workspace

get_conversation

Get information about a specific conversation (also known as a ticket)

search_conversations

Search conversations (also known as tickets) using filters

reply_to_conversation

Reply to a conversation (also known as a ticket)

close_conversation

Close a conversation (also known as a ticket)

open_conversation

Open a conversation (also known as a ticket)

assign_conversation

Assign a conversation (also known as a ticket) to an admin or team

validate_credential

Validate Intercom credentials. Verifies credentials during setup.

View all tools by creating a free account See more tools

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

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

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.