# Intercom MCP for AI Agents AI Agent Connect

> Intercom lets you connect your customer support and CRM data directly to your AI agent. Use it to manage conversations, search for leads, and update customer records without switching tabs. It handles everything from replying to active tickets to pulling up company profiles for your sales team. It turns your AI into a functional team member that can actually see and act on your customer data.

## Overview
- **Category:** talk-to-me
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_qjQhPxJ7qYN7NgDhKZcSOyVeXrRGBw50IyiZijRv/ai-agent-connect
- **Tags:** conversational-ai, helpdesk, customer-messaging, crm-integration, support-automation

## Description

Managing customer relationships usually involves a lot of tab-switching. You're constantly jumping between your inbox, your CRM, and your internal notes just to give a customer a straight answer. It's a lot of clicking and copy-pasting just to answer one simple question. This Connector changes that by bringing your Intercom data directly into your AI agent's workspace. Instead of hunting for a specific person's history, you can just ask your agent to find them. It can pull up a company's profile, show you their recent chat history, or let you send a follow-up message on the fly. It makes the process of handling tickets or researching leads feel like a single, continuous conversation. When you use this through the Vinkius catalog, you're not just adding a feature; you're giving your agent a way to actually do the work. It handles the tedious stuff like listing admin roles or checking custom attributes so you can focus on the actual human interaction. For support teams, this means getting the context of a past issue without digging through old threads. For sales teams, it means identifying high-value leads and their specific company data in seconds. Whether you're trying to resolve a complex support issue or qualify a new lead for the sales team, the data you need is always just one prompt away.

## Tools

### create_contact
Register a new person in your Intercom database. This lets you add new leads or customers quickly without leaving your chat interface.

### create_conversation
Start a fresh chat thread with a customer. Use this to initiate a new support ticket or a sales outreach thread.

### get_contact_details
Pull up a specific person's profile and tags. You'll get a clear view of a customer's history and attributes instantly.

### get_conversation_details
See the full message history for a specific thread. This helps you understand the context of a customer's issue before you reply.

### list_admins
See who has administrative access to your workspace. Use this to manage team permissions and see who has high-level access.

### list_help_articles
Pull a list of articles from your help center. This helps your agent find the right documentation to share with customers.

### list_contacts
Get a list of all people in your Intercom account. You can browse your entire customer base to see who you're currently talking to.

### list_conversations
View your most recent customer chats. This lets you see what's currently happening in your support queue.

### list_data_attributes
See the custom fields you've set up for your data. Use this to understand what specific CRM information your agent can access.

### list_segments
View the different customer groups you've created. This helps your agent identify specific types of leads or users.

### reply_to_conversation
Send a message back to a customer in an active chat. Your agent can use this to provide quick, accurate answers to live questions.

### search_contacts
Find specific people using Intercom's query syntax. This is the fastest way to locate a customer when they only give you a name or email.

## Prompt Examples

**Prompt:** 
```
Find the last 3 messages from Sarah Jenkins and tell me what she's upset about.
```

**Response:** 
```
I found the recent conversation with Sarah Jenkins. Here's the summary:

* She's frustrated with the recent shipping delay.
* She mentioned her order #12345 hasn't arrived.
* She wants a refund or a discount on her next order.

Would you like me to draft a reply to her?
```

**Prompt:** 
```
Show me all the contacts in the 'High Value' segment.
```

**Response:** 
```
I've pulled the contacts from the 'High Value' segment:

| Name | Company | Status |
| :--- | :--- | :--- |
| John Doe | Acme Corp | Active |
| Jane Smith | Globex | Pending |

I can also pull the specific details for any of these if you need.
```

**Prompt:** 
```
Create a new contact for a lead named Mike Ross at MikeRoss.com.
```

**Response:** 
```
Done! I've registered Mike Ross as a new contact.

**Details:**
* **Name:** Mike Ross
* **Email:** MikeRoss.com
* **Status:** New Lead

I've also started a new conversation thread for him so you can begin the outreach.
```

## Capabilities

### Reply to customer messages
Your agent can send direct responses to active conversation threads.

### Search for contacts
Find specific people using email, name, or other CRM filters.

### View conversation history
Look up the full thread of past messages for any customer.

### Create new records
Register new contacts and start new conversations automatically.

### Manage workspace admins
List and view all team members with administrative permissions.

### Access custom attributes
Retrieve specific custom data fields you've set up in your CRM.

## Use Cases

### Resolving support tickets
A customer asks about a refund. The agent uses get_conversation_details to see the past issue and reply_to_conversation to give an update.

### Sales lead research
A rep wants to find all 'Enterprise' leads. The agent uses list_segments and search_contacts to pull a list of qualified prospects.

### New customer onboarding
A new user joins. The agent uses create_contact to register them and create_conversation to start a welcome thread automatically.

### Team audit
An admin needs to see who is on the team. The agent uses list_admins to provide a full roster of workspace permissions.

## Benefits

- Stop switching tabs between your CRM and chat app by using search_contacts and list_contacts to find data instantly.
- Reply to customers faster with reply_to_conversation, which lets your agent handle follow-ups without you manually typing every line.
- Get a full picture of a customer's history by using get_conversation_details to see every past interaction in one place.
- Keep your database clean by using create_contact and create_conversation to add new people and threads automatically.
- Access internal knowledge faster with list_help_articles to pull relevant info for your team.
- Manage permissions easily with list_admins to see who has access to your workspace.

## How It Works

The bottom line is you get a way to manage your entire customer database through a chat interface.

1. Get your Intercom Access Token from the developer hub.
2. Subscribe to this Connector and enter your token in the settings.
3. Start asking your agent to find, message, or update customers.

## Frequently Asked Questions

**Can the Intercom MCP help my support team answer tickets faster?**
Yes. It lets your AI agent pull up customer history and reply to conversations directly, cutting out the time spent switching between tabs.

**How does the Intercom MCP handle our custom CRM data?**
It can access your custom attributes and segments. Your agent can search for specific data points you've already defined in your Intercom account.

**Can I use the Intercom MCP to find specific customers by email?**
Absolutely. You can ask your agent to search for any contact using their email or name, and it'll pull up their profile instantly.

**Will the Intercom MCP let my agent send messages to my customers?**
Yes, it can send replies to active conversations. This means your agent can handle follow-ups or status updates on your behalf.

**Is the Intercom MCP good for sales lead research?**
It's great for that. Your agent can list segments and search for company profiles to give you a quick overview of a lead's history and status.

**Can the Intercom MCP see my help center articles?**
Yes, it can list help center articles. Your agent can use these to find the right information to give to your customers.

**Can I search for contacts and send messages through the AI agent?**
Yes. Use `search_contacts` to find contacts by email, name, or custom attributes. Then use `send_message` to send a message to a specific contact, or reply to an active conversation thread.

**Can I view full conversation histories?**
Yes. `list_conversations` shows all conversations with status. Use `get_conversation` with a conversation ID to retrieve the full message thread including sender, timestamps, and content.

**What type of Intercom token do I need?**
You need an **Access Token** from a Private App in the Intercom Developer Hub. This provides scoped API access with Bearer authentication against `api.intercom.io`.