Intercom MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Intercom MCP or direct API to send messages, fetch conversations, update contacts, and automate support workflows through natural language.

Get started for free Get a demo

Intercom

Oauth2

Intercom is a customer messaging platform for live chat and support automation. It helps businesses engage, convert, and support customers at scale.

133 Tools

Try Intercom now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND

Intercom

Enter ↵

Try asking

TOOLS

Supported Tools

Every Intercom action and event your agent gets out of the box.

Add subscription to a contact

You can add a specific subscription to a contact.

Add tag to contact

Tool to add a tag to a contact in Intercom.

Archive contact

Tool to archive a single contact in Intercom.

Assign conversation

Assigns a conversation to a specific admin or team in Intercom.

Attach contact to company

Tool to attach a contact to a company in Intercom.

Attach contact to conversation

Tool to attach a contact participant to a conversation on behalf of admin or contact.

Attach tag to conversation

Tool to add a tag to a specific conversation in Intercom.

Attach tag to ticket

Tool to add a tag to a ticket in Intercom.

Block contact

Tool to block a single contact in Intercom.

Cancel data export

Tool to cancel an active content data export job.

Close conversation

Closes a conversation in Intercom, marking it as resolved.

Create a collection

You can create a new collection by making a POST request to `https://api.

Create an article

You can create a new article by making a POST request to `https://api.

Create a note

You can add a note to a single contact.

Create contact

Tool to create a new contact in Intercom workspace.

Create content import source

Tool to create a new content import source for the Fin Content Library.

Create conversation

Creates a new conversation in Intercom.

Create data attribute

Tool to create a custom data attribute for contacts or companies.

Create data event

Tool to submit a data event to Intercom to track user activities.

Create data export

Tool to initiate an async data export job for message content.

Create external page

Tool to create an external page in Fin Content Library or update an existing page by external ID.

Create help center section

Tool to create a new help center section within a collection.

Create internal article

Tool to create a new internal article for team knowledge sharing.

Create or update a company

You can create or update a company.

Create or update tag

Tool to create or update a tag, and optionally tag/untag companies or tag contacts.

Create ticket

Tool to create a ticket in Intercom to track customer requests and issues.

Create a ticket type

Tool to create a new ticket type that defines the data structure for tracking customer requests.

Create ticket type attribute

Tool to create a new attribute for a ticket type in Intercom.

Create event summaries

Tool to create event summaries for a user to track event occurrences.

Delete a collection

You can delete a single collection by making a DELETE request to `https://api.

Delete a company

You can delete a single company.

Delete an article

You can delete a single article by making a DELETE request to `https://api.

Delete a tag

Tool to delete a tag from Intercom workspace.

Delete a visitor

Tool to delete a visitor from the Intercom workspace.

Delete a contact

Tool to delete a contact from the Intercom workspace.

Delete content import source

Tool to delete a content import source and all its external pages.

Delete external page

Tool to delete an external page from content library and AI answers.

Delete internal article

Tool to delete a single internal article by ID.

Delete ticket

Tool to delete a ticket from the Intercom system.

Detach a contact from tag

Tool to remove a tag from a specific contact in Intercom.

Detach contact from company

Tool to detach a contact from a company in Intercom.

Detach tag from conversation

Tool to remove a tag from a specific conversation in Intercom.

Detach tag from ticket

Tool to remove a tag from a ticket in Intercom.

Download data export

Tool to download content data export from Intercom.

Enqueue create ticket

Tool to enqueue ticket creation for asynchronous processing.

Find a tag

Tool to retrieve details for a specific tag by its ID.

Get a contact

You can fetch the details of a single contact.

Get content import source

Tool to retrieve a content import source by its ID.

Get conversation

Retrieves a specific conversation by ID with all messages and details.

Get entity counts

Tool to retrieve summary counts for Intercom app entities including companies, users, leads, tags, segments, and conversations.

Get custom object instance by external ID

Tool to retrieve a custom object instance by its external_id.

Get external page

Tool to retrieve an external page from Fin Content Library by ID.

Get ticket

Tool to retrieve a ticket from Intercom.

Get a ticket type

Tool to retrieve details for a specific ticket type by its ID.

Identify an admin

You can view the currently authorised admin along with the embedded app object (a "workspace" in legacy terminology).

Retrieve job status

Tool to retrieve the status of job execution.

List all activity logs

You can get a log of activities by all admins in an app.

List all admins

You can fetch a list of admins for a given workspace.

List all articles

You can fetch a list of all articles by making a GET request to `https://api.

List all collections

You can fetch a list of all collections by making a GET request to `https://api.

List all companies

You can list companies.

List all help centers

You can list all Help Centers by making a GET request to `https://api.

List all macros

Tool to fetch a list of all macros (saved replies) in your workspace for use in automating responses.

List all notes

You can fetch a list of notes that are associated to a contact.

List attached companies for contact

You can fetch a list of companies that are associated to a contact.

List attached contacts

You can fetch a list of all contacts that belong to a company.

List attached segments for companies

You can fetch a list of all segments that belong to a company.

List attached segments for contact

You can fetch a list of segments that are associated to a contact.

List away status reasons

Tool to retrieve all away status reasons for a workspace including deleted ones.

List calls

Tool to list all phone calls from Intercom with pagination support.

List calls with transcripts

Tool to retrieve calls by conversation IDs with transcripts when available.

List company notes

Tool to list all notes associated with a specific company.

List all contacts

Tool to list all contacts (users or leads) in your Intercom workspace with pagination support.

List content import sources

Tool to retrieve all content import sources for the workspace.

List conversations

Lists all conversations from Intercom with pagination support.

List data attributes

Tool to list all data attributes for contacts, companies, and conversations.

List data events

Tool to retrieve a log of data events belonging to a customer.

List external pages

Tool to list all external pages from Fin Content Library.

List help center sections

Tool to fetch a list of all help center sections in descending order by updated_at.

List internal articles

Fetches one page of internal articles from Intercom.

List all news items

Tool to fetch a list of all news items from Intercom.

List all segments

Tool to retrieve all segments defined within a workspace for filtering and categorizing contacts.

List subscriptions for a contact

You can fetch a list of subscription types that are attached to a contact.

List subscription types

Tool to list all subscription types available in the workspace.

List all tags

Tool to fetch all tags for the workspace.

List tags attached to a contact

You can fetch a list of all tags that are attached to a specific contact.

List all teams

Tool to retrieve all teams within a workspace.

List all ticket states

Tool to fetch all ticket states for the workspace.

List all ticket types

Tool to retrieve all ticket types for the workspace.

Merge a lead and a user

You can merge a contact with a `role` of `lead` into a contact with a `role` of `user`.

Tool to register a Fin Voice call with Intercom.

Remove subscription from a contact

You can remove a specific subscription from a contact.

Remove tag from a contact

You can remove tag from a specific contact.

Reopen conversation

Reopens a closed conversation in Intercom.

Reply to ticket

Tool to reply to a ticket with a message from admin or contact, or with a note for admins.

Reply to conversation

Sends a reply to an existing conversation in Intercom.

Retrieve a collection

You can fetch the details of a single collection by making a GET request to `https://api.

Retrieve a company by id

You can fetch a single company.

Retrieve a help center

You can fetch the details of a single Help Center by making a GET request to `https://api.

Retrieve job status

Tool to retrieve the status of a data export job.

Retrieve a macro

Tool to fetch a single macro (saved reply) by its ID.

Retrieve an admin

You can retrieve the details of a single admin.

Retrieve an article

You can fetch the details of a single article by making a GET request to `https://api.

Retrieve a segment

Tool to retrieve details for a single segment by its ID.

Retrieve companies

You can fetch a single company by passing in `company_id` or `name`.

Retrieve internal article

Tool to retrieve an internal article by ID from Intercom.

Retrieve note

Tool to retrieve details of a single note by its identifier.

Retrieve a team

Tool to retrieve detailed information about a specific team by ID.

Retrieve visitor with user ID

Tool to retrieve a specific visitor's details using their user_id.

Scroll over all companies

The `list all companies` functionality does not work well for huge datasets, and can result in errors and performance problems when paging deeply.

Search contacts

Tool to search for contacts using query filters with operators.

Search conversations

Searches for conversations using query string with support for filtering and sorting

Search for articles

You can search for articles by making a GET request to `https://api.

Search internal articles

Searches one page of internal articles in Intercom.

Search tickets

Tool to search tickets in Intercom by filtering attribute values.

Set admin to away

Tool to set an admin to away status in Intercom.

Set an admin to away

You can set an Admin as away for the Inbox.

Show call

Tool to retrieve a single call by ID from Intercom.

Show call transcript

Tool to get call transcript by call ID.

Show contact by external ID

Tool to retrieve a contact by their external ID.

Unarchive contact

Tool to unarchive a previously archived contact in Intercom.

Update a collection

You can update the details of a single collection by making a PUT request to `https://api.

Update a company

You can update a single company using the Intercom provisioned `id`.

Update a contact

You can update an existing contact (ie.

Update an article

You can update the details of a single article by making a PUT request to `https://api.

Update contact

Tool to update an existing contact in Intercom.

Update content import source

Tool to update an existing content import source in Fin Content Library.

Update data attribute

Tool to update an existing data attribute in Intercom.

Update external page

Tool to update an existing external page in Fin Content Library.

Update internal article

Tool to update an internal article with new title, body, author or owner information.

Update ticket

Tool to update an existing ticket in Intercom.

Update a ticket type

Tool to update an existing ticket type in the workspace.

Update ticket type attribute

Tool to update an existing attribute for a ticket type.

SETUP GUIDE

Connect Intercom MCP Tool with your Agent

Install Composio

typescript

npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp

Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

typescript

import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);

Initialize the Composio client and create a Tool Router session

Connect to AI Agent

typescript

import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Assign conversation #1234 to support team' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);

Use the MCP server with your AI agent

SETUP GUIDE

Connect Intercom API Tool with your Agent

Install Composio

typescript

npm install @composio/openai

Install the Composio SDK

Initialize Composio and Create Tool Router Session

typescript

import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');

Import and initialize Composio client, then create a Tool Router session

Execute Intercom Tools via Tool Router with Your Agent

typescript

const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Assign latest conversation to support team'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);

Get tools from Tool Router session and execute Intercom actions with your Agent

Guide

Connect multiple Intercom accounts to Claude and tell it which one to use by name.

Read the guide

Why Use Composio?

AI Native Intercom Integration

Supports both Intercom MCP and direct API based integrations
Structured, LLM-friendly schemas for reliable tool execution
Rich coverage for reading, writing, and querying your Intercom data

Managed Auth

Built-in OAuth handling with automatic token refresh and rotation
Central place to manage, scope, and revoke Intercom access
Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

Tools are tuned using real error and success rates to improve reliability over time
Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

Fine-grained RBAC so you control which agents and users can access Intercom
Scoped, least privilege access to Intercom resources
Full audit trail of agent actions to support review and compliance

FRAMEWORKS

Use Intercom with any AI Agent Framework

Choose a Framework you want to connect Intercom with

Claude Code

Use Intercom MCP with Claude Code

Cursor

Use Intercom MCP with Cursor

ChatGPT

Use Intercom MCP with ChatGPT

Claude Cowork

Use Intercom MCP with Claude Cowork

Antigravity

Use Intercom MCP with Antigravity

OpenAI Agents SDK

Use Intercom MCP with OpenAI Agents SDK

Claude Agents SDK

Use Intercom MCP with Claude Agents SDK

Grok Bot

Use Intercom MCP with Grok Bot

Codex

Use Intercom MCP with Codex

Grok Build

Use Intercom MCP with Grok Build

VS Code

Use Intercom MCP with VS Code

OpenCode

Use Intercom MCP with OpenCode

OpenClaw

Use Intercom MCP with OpenClaw

Hermes

Use Intercom MCP with Hermes

Atomic Agent

Use Intercom MCP with Atomic Agent

Google ADK

Use Intercom MCP with Google ADK

Langchain

Use Intercom MCP with Langchain

AI SDK

Use Intercom MCP with AI SDK

Mastra AI

Use Intercom MCP with Mastra AI

LlamaIndex

Use Intercom MCP with LlamaIndex

CrewAI

Use Intercom MCP with CrewAI

Pydantic AI

Use Intercom MCP with Pydantic AI

Autogen

Use Intercom MCP with Autogen

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Aeroleads

Api Key

Aeroleads is a B2B lead generation platform for finding business emails and phone numbers. Grow your sales pipeline faster with powerful prospecting tools.

Autobound

Api Key

Autobound is an AI-powered sales engagement platform that crafts hyper-personalized outreach and insights. It helps sales teams boost response rates and close more deals through tailored content and recommendations.

Better proposals

Api Key

Better Proposals is a web-based tool for crafting and sending professional proposals. It helps teams impress clients and close deals faster with slick, easy-to-use templates.

Bidsketch

Api Key

Bidsketch is a proposal software that helps businesses create professional proposals quickly and efficiently. It streamlines the proposal process, saving time while boosting client win rates.

FAQ

Frequently asked questions

No. Composio provides a managed OAuth app for Intercom, so you sign in with your normal Intercom account and approve access. If you later want the consent screen to show your own company name, you can add your own Intercom OAuth app in the Composio dashboard, and every connection after that uses it.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Intercom connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a Intercom account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Intercom as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones Intercom lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your Intercom administrator may need to approve the app first, and you can revoke the access inside Intercom whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Intercom connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes Intercom tokens automatically, so day to day you do nothing. If you revoke access inside Intercom, or Intercom invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free plan includes 100,000 tool calls per month with no credit card, and up to 20,000 of those can run through Composio-managed apps like Intercom. Personal Intercom use rarely gets near that. Paid plans add higher limits and team features, and Intercom's own pricing is unaffected.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Intercom accounts).

With Composio, you connect Intercom once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Intercom.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Intercom tool your agent needs.Free to start.

Start building

Intercom MCP server for AI agents and assistants

Try Intercom now

Supported Tools

Connect Intercom MCP Tool with your Agent

Install Composio

Create Tool Router Session

Connect to AI Agent

Connect Intercom API Tool with your Agent

Install Composio

Initialize Composio and Create Tool Router Session

Execute Intercom Tools via Tool Router with Your Agent

Why Use Composio?

AI Native Intercom Integration

Managed Auth

Agent Optimized Design

Enterprise Grade Security

Use Intercom with any AI Agent Framework

Claude Code

Cursor

ChatGPT

Claude Cowork

Antigravity

OpenAI Agents SDK

Claude Agents SDK

Grok Bot

Codex

Grok Build

VS Code

OpenCode

OpenClaw

Hermes

Atomic Agent

Google ADK

Langchain

AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

Autogen

Rolling this out across your team?

Explore Other Toolkits

Aeroleads

Autobound

Better proposals

Bidsketch

Frequently asked questions

Do I need my own Intercom developer credentials or OAuth app?+

Can I use multiple toolkits together?+

Is Composio secure with my Intercom account?+

What if the API changes?+

Does the agent act as me inside Intercom?+

Which Intercom permissions does Composio get?+

Can I use multiple Intercom accounts with Claude and ChatGPT?+

What happens when my Intercom access expires or I revoke it?+

Does using Intercom through Composio cost extra?+

How is Composio different from the Intercom connectors already built into Claude and ChatGPT?+

Start with Intercom.It takes 30 seconds.