How to integrate Intercom MCP with OpenCode

Trusted by
AWS
Glean
Zoom
Airtable

30 min · no commitment · see it on your stack

Intercom logo
OpenCode logo
divider

How to integrate Intercom MCP with OpenCode

This guide explains how to connect Intercom MCP to OpenCode using Composio Connect, which simplifies OAuth, API changes, and reliability concerns.

There are two ways to set this up:

Also integrate Intercom with

Why use Composio?

Composio provides a single MCP server or CLI tool that exposes a set of meta-tools, allowing you to:

  • Connect to 1,000+ apps with on-demand tool loading, so you do not fill your LLM context window with unnecessary tool definitions.
  • Use programmatic tool calling through a remote Bash tool, letting LLMs write their own code to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
  • Handle large tool responses outside the LLM context to keep conversations lean.

Connect Intercom with OpenCode

Option 1: Using Composio CLI

1. Install Composio CLI

Install the Composio CLI, authenticate, and initialize your project:

bash
# Install the Composio CLI
curl -fsSL https://composio.dev/install | bash

# Authenticate with Composio
composio login

During login, you will be redirected to the sign-in page. Finish the flow and you are all set.

Composio CLI authorization screen

2. Authorize Intercom

Once the CLI is installed, it is essentially done. Give OpenCode access to your apps with these steps:

  1. Launch OpenCode.
  2. Prompt it to "Authenticate with Intercom Composio".
  3. Complete the authentication and authorization flow, and your Intercom integration is all set.
  4. Start asking anything you want.

Option 2: Using Composio MCP

You can also connect Intercom to OpenCode by adding Composio as an MCP server through the OpenCode CLI.

1. Add the Composio MCP server

bash
opencode mcp add

This launches an interactive prompt.

2. Fill in the fields

FieldValue
Namecomposio
Typeremote
URLhttps://connect.composio.dev/mcp
Require OAuthYes
Have client IDNo
OpenCode MCP server interactive prompt for Composio

Alternatively, you can skip the interactive prompt and paste the configuration directly into your OpenCode config file.

Open your global OpenCode config:

bash
open ~/.config/opencode/opencode.json

Add this under the mcp key and save the file.

bash
{
  "mcp": {
    "composio": {
      "type": "remote",
      "url": "https://connect.composio.dev/mcp",
      "enabled": true
    }
  }
}

3. Authenticate

Authenticate the Composio MCP server you just added:

bash
opencode mcp auth composio

This opens a browser session. Authorize Composio and you are done.

Composio browser authorization for OpenCode MCP

4. Verify installation

bash
opencode mcp list

5. Connect Intercom with OpenCode

Now, in the chat, ask the agent to connect to Intercom or give it any Intercom-related task.

For example, ask it to:

  • "Add tag 'VIP' to contact John Doe"
  • "Assign open conversation #123 to support team"
  • "Create note for contact Emily about refund"

It will prompt you to authenticate and authorize access to Intercom.

That is it. Composio tools are now available in OpenCode, and your Intercom account is ready to use.

Supported Tools & Triggers

Tools
Add subscription to a contactYou can add a specific subscription to a contact.
Add tag to contactTool to add a tag to a contact in Intercom.
Archive contactTool to archive a single contact in Intercom.
Assign conversationAssigns a conversation to a specific admin or team in Intercom.
Attach contact to companyTool to attach a contact to a company in Intercom.
Attach contact to conversationTool to attach a contact participant to a conversation on behalf of admin or contact.
Attach tag to conversationTool to add a tag to a specific conversation in Intercom.
Attach tag to ticketTool to add a tag to a ticket in Intercom.
Block contactTool to block a single contact in Intercom.
Cancel data exportTool to cancel an active content data export job.
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 contactTool to create a new contact in Intercom workspace.
Create content import sourceTool to create a new content import source for the Fin Content Library.
Create conversationCreates a new conversation in Intercom.
Create data attributeTool to create a custom data attribute for contacts or companies.
Create data eventTool to submit a data event to Intercom to track user activities.
Create data exportTool to initiate an async data export job for message content.
Create external pageTool to create an external page in Fin Content Library or update an existing page by external ID.
Create help center sectionTool to create a new help center section within a collection.
Create internal articleTool to create a new internal article for team knowledge sharing.
Create or update a companyYou can create or update a company.
Create or update tagTool to create or update a tag, and optionally tag/untag companies or tag contacts.
Create ticketTool to create a ticket in Intercom to track customer requests and issues.
Create a ticket typeTool to create a new ticket type that defines the data structure for tracking customer requests.
Create ticket type attributeTool to create a new attribute for a ticket type in Intercom.
Create event summariesTool to create event summaries for a user to track event occurrences.
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 an articleYou can delete a single article by making a DELETE request to `https://api.
Delete a tagTool to delete a tag from Intercom workspace.
Delete a visitorTool to delete a visitor from the Intercom workspace.
Delete a contactTool to delete a contact from the Intercom workspace.
Delete content import sourceTool to delete a content import source and all its external pages.
Delete external pageTool to delete an external page from content library and AI answers.
Delete internal articleTool to delete a single internal article by ID.
Delete ticketTool to delete a ticket from the Intercom system.
Detach a contact from tagTool to remove a tag from a specific contact in Intercom.
Detach contact from companyTool to detach a contact from a company in Intercom.
Detach tag from conversationTool to remove a tag from a specific conversation in Intercom.
Detach tag from ticketTool to remove a tag from a ticket in Intercom.
Download data exportTool to download content data export from Intercom.
Enqueue create ticketTool to enqueue ticket creation for asynchronous processing.
Find a tagTool to retrieve details for a specific tag by its ID.
Get a contactYou can fetch the details of a single contact.
Get content import sourceTool to retrieve a content import source by its ID.
Get conversationRetrieves a specific conversation by ID with all messages and details.
Get entity countsTool to retrieve summary counts for Intercom app entities including companies, users, leads, tags, segments, and conversations.
Get custom object instance by external IDTool to retrieve a custom object instance by its external_id.
Get external pageTool to retrieve an external page from Fin Content Library by ID.
Get ticketTool to retrieve a ticket from Intercom.
Get a ticket typeTool to retrieve details for a specific ticket type by its ID.
Identify an adminYou can view the currently authorised admin along with the embedded app object (a "workspace" in legacy terminology).
Retrieve job statusTool to retrieve the status of job execution.
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 macrosTool to fetch a list of all macros (saved replies) in your workspace for use in automating responses.
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 away status reasonsTool to retrieve all away status reasons for a workspace including deleted ones.
List callsTool to list all phone calls from Intercom with pagination support.
List calls with transcriptsTool to retrieve calls by conversation IDs with transcripts when available.
List company notesTool to list all notes associated with a specific company.
List all contactsTool to list all contacts (users or leads) in your Intercom workspace with pagination support.
List content import sourcesTool to retrieve all content import sources for the workspace.
List conversationsLists all conversations from Intercom with pagination support.
List data attributesTool to list all data attributes for contacts, companies, and conversations.
List data eventsTool to retrieve a log of data events belonging to a customer.
List external pagesTool to list all external pages from Fin Content Library.
List help center sectionsTool to fetch a list of all help center sections in descending order by updated_at.
List internal articlesFetches one page of internal articles from Intercom.
List all news itemsTool to fetch a list of all news items from Intercom.
List all segmentsTool to retrieve all segments defined within a workspace for filtering and categorizing contacts.
List subscriptions for a contactYou can fetch a list of subscription types that are attached to a contact.
List subscription typesTool to list all subscription types available in the workspace.
List all tagsTool to fetch all tags for the workspace.
List tags attached to a contactYou can fetch a list of all tags that are attached to a specific contact.
List all teamsTool to retrieve all teams within a workspace.
List all ticket statesTool to fetch all ticket states for the workspace.
List all ticket typesTool to retrieve all ticket types for the workspace.
Merge a lead and a userYou can merge a contact with a `role` of `lead` into a contact with a `role` of `user`.
Register Fin Voice callTool to register a Fin Voice call with Intercom.
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 ticketTool to reply to a ticket with a message from admin or contact, or with a note for admins.
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 job statusTool to retrieve the status of a data export job.
Retrieve a macroTool to fetch a single macro (saved reply) by its ID.
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 a segmentTool to retrieve details for a single segment by its ID.
Retrieve companiesYou can fetch a single company by passing in `company_id` or `name`.
Retrieve internal articleTool to retrieve an internal article by ID from Intercom.
Retrieve noteTool to retrieve details of a single note by its identifier.
Retrieve a teamTool to retrieve detailed information about a specific team by ID.
Retrieve visitor with user IDTool to retrieve a specific visitor's details using their user_id.
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 contactsTool to search for contacts using query filters with operators.
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.
Search internal articlesSearches one page of internal articles in Intercom.
Search ticketsTool to search tickets in Intercom by filtering attribute values.
Set admin to awayTool to set an admin to away status in Intercom.
Set an admin to awayYou can set an Admin as away for the Inbox.
Show callTool to retrieve a single call by ID from Intercom.
Show call transcriptTool to get call transcript by call ID.
Show contact by external IDTool to retrieve a contact by their external ID.
Unarchive contactTool to unarchive a previously archived contact in Intercom.
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.
Update contactTool to update an existing contact in Intercom.
Update content import sourceTool to update an existing content import source in Fin Content Library.
Update data attributeTool to update an existing data attribute in Intercom.
Update external pageTool to update an existing external page in Fin Content Library.
Update internal articleTool to update an internal article with new title, body, author or owner information.
Update ticketTool to update an existing ticket in Intercom.
Update a ticket typeTool to update an existing ticket type in the workspace.
Update ticket type attributeTool to update an existing attribute for a ticket type.

Way Forward

Now that Intercom is connected, extend your setup by connecting the other apps you already use every day, so your agent can run true cross-app workflows end to end.

  • Connect Calendar to turn threads into scheduled meetings automatically.
  • Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
  • Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
  • Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.

Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single MCP endpoint, your agent can coordinate multiple tools safely and reliably in one conversation.

How to build Intercom MCP Agent with another framework

FAQ

What are the differences in Tool Router MCP and Intercom MCP?

With a standalone Intercom MCP server, the agents and LLMs can only access a fixed set of Intercom tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Intercom and many other apps based on the task at hand, all through a single MCP endpoint.

Can I use Tool Router MCP with OpenCode?

Yes, you can. OpenCode fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Intercom tools.

Can I manage the permissions and scopes for Intercom while using Tool Router?

Yes, absolutely. You can configure which Intercom scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Intercom data and credentials are handled as safely as possible.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
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.