Intercom MCP Server
Intercom MCP server
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:
- Navigate to Settings > MCP Store > Intercom.
- Click on 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 |
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 Admin 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.