Connect your AI Agents to Intercom in minutes

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}
11Open 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}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 }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}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


































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
