Intercom Integration for AI Agents

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.
BOOK A CALLGET STARTED FOR FREE
Intercom Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Supported Tools

Tools
Add subscription to a contactYou can add a specific subscription to a contact.
Add tag to a contactYou can tag a specific contact.
Assign conversationAssigns a conversation to a specific admin or team in intercom
Attach a contact to a companyYou can attach a company to a single contact.
Close conversationCloses a conversation in intercom, marking it as resolved
Create a collectionYou can create a new collection by making a post request to `https://api.
Create an articleYou can create a new article by making a post request to `https://api.
Create a noteYou can add a note to a single contact.
Create conversationCreates a new conversation in intercom
Create or update a companyYou can create or update a company.
Delete a collectionYou can delete a single collection by making a delete request to `https://api.
Delete a companyYou can delete a single company.
Delete a contactYou can delete a single contact.
Delete an articleYou can delete a single article by making a delete request to `https://api.
Detach a contact from a companyYou can detach a company from a single contact.
Get a contactYou can fetch the details of a single contact.
Get conversationRetrieves a specific conversation by id with all messages and details
Identify an adminYou can view the currently authorised admin along with the embedded app object (a "workspace" in legacy terminology).
List all activity logsYou can get a log of activities by all admins in an app.
List all adminsYou can fetch a list of admins for a given workspace.
List all articlesYou can fetch a list of all articles by making a get request to `https://api.
List all collectionsYou can fetch a list of all collections by making a get request to `https://api.
List all companiesYou can list companies.
List all help centersYou can list all help centers by making a get request to `https://api.
List all notesYou can fetch a list of notes that are associated to a contact.
List attached companies for contactYou can fetch a list of companies that are associated to a contact.
List attached contactsYou can fetch a list of all contacts that belong to a company.
List attached segments for companiesYou can fetch a list of all segments that belong to a company.
List attached segments for contactYou can fetch a list of segments that are associated to a contact.
List conversationsLists conversations from intercom with filtering and pagination support
List subscriptions for a contactYou can fetch a list of subscription types that are attached to a contact.
List tags attached to a contactYou can fetch a list of all tags that are attached to a specific contact.
Merge a lead and a userYou can merge a contact with a `role` of `lead` into a contact with a `role` of `user`.
Remove subscription from a contactYou can remove a specific subscription from a contact.
Remove tag from a contactYou can remove tag from a specific contact.
Reopen conversationReopens a closed conversation in intercom
Reply to conversationSends a reply to an existing conversation in intercom
Retrieve a collectionYou can fetch the details of a single collection by making a get request to `https://api.
Retrieve a company by idYou can fetch a single company.
Retrieve a help centerYou can fetch the details of a single help center by making a get request to `https://api.
Retrieve an adminYou can retrieve the details of a single admin.
Retrieve an articleYou can fetch the details of a single article by making a get request to `https://api.
Retrieve companiesYou can fetch a single company by passing in `company id` or `name`.
Scroll over all companiesThe `list all companies` functionality does not work well for huge datasets, and can result in errors and performance problems when paging deeply.
Search conversationsSearches for conversations using query string with support for filtering and sorting
Search for articlesYou can search for articles by making a get request to `https://api.
Set an admin to awayYou can set an admin as away for the inbox.
Update a collectionYou can update the details of a single collection by making a put request to `https://api.
Update a companyYou can update a single company using the intercom provisioned `id`.
Update a contactYou can update an existing contact (ie.
Update an articleYou can update the details of a single article by making a put request to `https://api.

Connect Intercom MCP Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Intercom tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Assign conversation #1234 to support team')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent

Connect Intercom API Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio_openai
Install the Composio SDK

Initialize Composio and Create Tool Router Session

python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
Import and initialize Composio client, then create a Tool Router session

Execute Intercom Tools via Tool Router with Your Agent

python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Assign latest conversation to support team'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
Get tools from Tool Router session and execute Intercom actions with your Agent

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

Use Intercom with any AI Agent Framework

Choose a Framework you want to connect Intercom with

Frequently Asked Questions

Do I need my own developer credentials to use Intercom with Composio?

No, you can get started immediately using Composio's built-in Intercom app. For production, we recommend configuring your own OAuth credentials.

Can I use multiple toolkits together?

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

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

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

Used by agents from

Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free