Intercom MCP server | Atomicwork

Connect the Intercom MCP server

Connect the Intercom MCP server to Atomicwork to grant AI Coworkers access to your Intercom tools.

Integrating the Intercom Model Context Protocol (MCP) server with Atomicwork gives your AI Coworkers, automated workflows, and coding agents access to your Intercom environment. Once connected, your AI Workforce can securely interact with Intercom to manage contacts, conversations, tickets, and Help Center articles directly within your workspace.

Meet the setup prerequisites

Before you begin the setup, ensure that you meet the following access requirements:

Atomicwork admin access: You need organization administrator permissions in Atomicwork to access the MCP store.
Intercom admin access: You need administrator access in Intercom to authorize the secure OAuth connection.

Connect the Intercom MCP server

Follow these steps to establish the OAuth connection between Atomicwork and Intercom:

Go to AI Workforce > AI Registry > MCP store > Intercom.
Click the Intercom tile and select Connect.
Complete the secure OAuth authorization flow by logging in with your Intercom administrator credentials and authorizing the connection.Review and accept the workspace and administrative permissions to enable full tool functionality.
View the list of available Intercom tools displayed on your screen once the setup is complete. The exact tools available depend on your software platform and can be updated according to your organization’s needs.

Understanding permissions

Permission	Usecase	Available
Read and list users and companies	List and view all segments, users and companies	Y
Write users and companies	Create and update users and companies	Y
Read and write users	List all users and execute bulk actions	Y
Read one user and one company	List and view a single user and company	Y
Read events	List all events belonging to a single user	Y
Write events	Submit events (i.e. user activity)	Y
Read conversations	View conversations	Y
Write conversations	Reply to, mark as read and close conversations	Y
Delete conversations and metrics	Delete conversations and metrics	Y
Read tags	List all tags	Y
Write tags	Create, update, use and delete tags	Y
Write data attributes	Create and update custom data attributes	Y
Read counts	Count users and companies with specified criteria	Y
Export message data	Export engagement data for messages such as open rate, click rate etc.	Y
Export content data	Export engagement data for content such as open rate, click rate etc.	Y
Read content data	Receive engagement events for content such as chat, post etc.	Y
Write tickets	Create tickets	Y
Read tickets	Read and list tickets	Y
Read and write custom object instances	Create, read, update and delete custom object instances	Y
Read status of jobs	Read status of jobs enqueued via the API	Y
Export reporting data	Export reporting data for datasets such as conversations, actions etc.	Y
Read reporting datasets	Read metadata about reporting datasets such as IDs and attributes	Y

Workspace data

Permission	Description	Status
Read admins	List and view all admins	Y
Update admins	Update away mode for admins	Y
Read one admin	View a single admin	Y
Read admin activity logs	List and view all admins and their activity in the app	Y
Read and list articles	List and view all articles	Y
Read and write articles	Read, update and create articles	Y
Read data when entered into the app	Gather data via Intercom Apps	Y
Create phone call redirects	Create phone call redirects	Y
Read and list news items and newsfeeds	List and view all News items and Newsfeeds	Y
Read and write news items and newsfeeds	Read, update and create news items and newsfeeds	Y
Read and write AI content	Create and update AI content	Y
Read brands	List and view brands	Y
Read and write data connectors	Configure data connectors and read execution results and execution webhooks	Y
Read data connectors	Access data connectors, execution results and execution webhooks	Y
Read emails	List and view email settings	Y
Read API activity	Receive webhook notifications for API requests made to your workspace	Y
Manage IP allowlist	Read and update IP allowlist settings for the workspace	Y
Read content snippets	List and view content snippets	N
Read and write content snippets	Create, read and list content snippets	Y
Read identity verification secrets	List identity verification secrets (metadata only — secrets are never returned by list responses)	N
Manage identity verification secrets	Create and delete identity verification secrets (self-served rotation of Messenger HMAC secrets)	N
Read audiences	List audiences	N
Read and write audiences	Read, create, update, and delete audiences	N
Search content	Search articles, content snippets, external pages, uploaded files, and internal articles	N
Write content	Bulk-modify articles, content snippets, external pages, uploaded files, and internal articles	N
Read and write office hours schedules	Read, create, update, and delete office hours schedules	N

Configure tool access for AI Coworkers

After completing the setup, you can control which tools your AI Coworkers can access. To maintain a secure workspace, we recommend following the principle of least privilege and granting only the minimum necessary capabilities.

Go to AI Workforce > AI Coworker > Tools.
Select the AI Coworker you want to configure.
Grant granular or complete access to the available Intercom tools based on your requirements. For more details on managing tools, see Setting up an AI Coworker.

Understand Intercom tool capabilities

Once connected, the Intercom MCP server provides a wide range of capabilities across your workspace. These tools are grouped into several broad categories:

Contacts and companies: Create, update, retrieve, search, and archive contacts or companies, and manage their associations.
Conversations and tickets: Create, search, assign, reply to, close, or reopen conversations and tickets.
Tags and subscriptions: Add, remove, find, or list tags and subscriptions for contacts, conversations, and tickets.
Help Center and articles: Create, update, search, list, and delete Help Center articles, collections, sections, and internal articles.
Data attributes and exports: Manage custom data attributes, events, and export reporting datasets.
Admins and teams: List admins, teams, activity logs, and manage admin away statuses.
Calls and transcripts: Register, show, and list calls along with transcripts.

Automate tasks with workflows and coding agents

In addition to standard AI Coworkers, the AI Assist workflow builder and the coding agent automatically have access to the Intercom MCP server. This allows you to build automated workflows and write custom code scripts that interact directly with your Intercom data.

Explore next steps

Now that you have connected the Intercom MCP server, explore how to configure other integrations in the MCP store. To learn how to connect other communication platforms, see Connect the Microsoft Teams MCP server or read our guide on Setting up an AI Coworker to start building your AI Workforce.