# Intercom MCP > Intercom MCP gives your AI client direct access to customer communication data. Use it to search contacts, view conversation history, and manage support metrics without ever opening the Intercom inbox. Get full context on users' account health, usage patterns, and recent interactions instantly. ## Overview - **Category:** talk-to-me - **Price:** Free - **Tags:** helpdesk, conversational-support, customer-data, sla-tracking, contact-management, proactive-support ## Description Managing customer support shouldn't require jumping between tabs or opening a separate dashboard. This MCP lets your AI agent handle all your communication needs conversationally. Instead of manually searching through contacts by name or email, you simply ask for the record, and the system pulls up everything from the user profile—including company details and plan information. Need to know how many conversations are open right now? You can request that data directly. The agent handles listing all customer interactions and even assigns them to specific team members if necessary. This capability lets support teams get instant context about a customer's history, their current status, and any associated tags or segments. Because this connection is hosted on the Vinkius platform, you connect once from your preferred AI client, giving it access to all these tools in one place. ## Tools ### create_contact Creates a new user or lead profile in Intercom using provided email, role, and name. ### update_contact Modifies an existing contact's record with specific field updates. ### assign_conversation Changes the owner of a support conversation to a specified team member. ### close_conversation Marks a support thread as resolved or closed, requiring an admin ID for finalization. ### list_conversations Generates a list of all active customer conversations currently in the system. ### list_contacts Retrieves a comprehensive list of every contact and lead registered in Intercom. ### list_tags Gets an inventory of all custom tags used across the customer base. ### list_segments Retrieves a list of defined user groups or segments within Intercom. ### get_contact Fetches all detailed information for one specific contact ID. ### search_contacts Searches the entire contact database using criteria like email, company name, or custom attributes. ### get_conversation Retrieves the full content and thread history for a single support conversation. ### reply_to_conversation Sends a message reply to an existing customer chat thread. ### list_companies Lists all company records associated with the user base. ### list_articles Retrieves a list of available help center articles and documentation titles. ### list_admins Provides a roster of all team members or administrators within the account. ## Prompt Examples **Prompt:** ``` Find the contact record for sarah@startup.io. ``` **Response:** ``` Found: Sarah Chen (sarah@startup.io). Company: Startup.io (Growth plan). Last seen: 2 hours ago. Total conversations: 12 (3 open). Custom attributes: MRR $2,400, Account Manager: James. ``` **Prompt:** ``` How many open conversations do we have right now? ``` **Response:** ``` You currently have 23 open conversations. Breakdown: 8 unassigned, 10 assigned to support agents, and 5 snoozed. The oldest open conversation is 4 hours old (assigned to Maria). ``` **Prompt:** ``` List all companies on our Enterprise plan. ``` **Response:** ``` I found 14 companies on the Enterprise plan. Top 5 by user count: Acme Corp (250 users), GlobalTech (180 users), DataFlow Inc (95 users), CloudFirst (72 users), and SecureStack (45 users). ``` ## Capabilities ### Find and update user records Search for contacts using email or name, or create a new lead profile within Intercom. ### Review entire conversation history Retrieve full threads of support chats or list all ongoing conversations to check status and assignment details. ### Manage user company data Get profiles for associated companies, including plan names and aggregate usage metrics. ### Improve team workflows Close or assign conversations to specific agents to track resolution status and ownership. ### List organizational assets Retrieve lists of all company tags, user segments, articles, and internal team members. ## Use Cases ### A sales rep needs to qualify a lead. The SDR asks their agent, 'Tell me everything on Acme Corp.' The agent uses `get_contact` and `list_companies` to pull up the company's plan status (Enterprise), number of users, and recent interactions. This allows the rep to jump right into a high-level discussion instead of starting from zero. ### A support agent handles an escalated ticket. The agent asks, 'What's the history for Jane Doe?' The agent uses `get_conversation` and `list_contacts` to instantly retrieve all past chats. They see that the issue was previously tagged as a billing concern and can reply with accurate information immediately. ### CSM needs an account health snapshot. The CSM asks, 'Show me how many users are on our Growth plan.' The agent uses `list_segments` and `list_companies` to pull a quantitative report of the client's usage distribution, helping them prioritize their renewal conversation. ### Team needs to clean up old records. A manager asks, 'List all conversations that haven't been touched in 30 days.' The agent uses `list_conversations` and can then run the `close_conversation` tool on stale threads, keeping the dashboard accurate. ## Benefits - Stop wasting time searching for user details. With the `search_contacts` tool, your agent finds a specific person's record using just their email or company name, giving you immediate access to their full profile and history. - Never lose track of an issue again. You can use `list_conversations` to get a status overview of every open chat thread in seconds, letting you know who owns what and how old the oldest ticket is. - Build better leads by enriching data on the fly. Use company listing tools to pull associated business profiles and plan names directly into your outreach script before you even make the first call. - Keep conversations flowing smoothly. Once a customer issue is solved, the agent can use `close_conversation` or `assign_conversation` to properly document resolution and hand off ownership. - Maintain accurate data hygiene by using tools like `create_contact` and `update_contact`. You can programmatically ensure that user profiles always have the most current information. ## How It Works The bottom line is: you tell your AI client what data you need, and it handles connecting to Intercom's entire database so you don't have to. 1. First, subscribe to the Intercom integration on Vinkius and generate a private access token from your Intercom Developer Hub. 2. Next, point your AI client to this MCP using that token. This authenticates your agent with Intercom's data streams. 3. Finally, just ask your agent what you need—like 'Show me the history for John Doe,' or 'List all open conversations.' The agent uses the tools to find and present the context. ## Frequently Asked Questions **How does Intercom MCP help with customer support metrics?** The agent can use tools like `list_conversations` to pull aggregated data on open tickets, helping you track team performance and identify bottlenecks. **Can I update a user's profile using Intercom MCP?** Yes. You can modify existing records using the `update_contact` tool after identifying the specific contact ID and defining the new fields. **Does Intercom MCP allow me to see all tags?** Absolutely. The agent runs `list_tags` to pull an inventory of every tag used in your customer base, which helps with segmentation and cleanup. **What if I need to start a new lead? Can Intercom MCP do that?** You can create new leads using the `create_contact` tool. You just provide the required role, email, and name, and the record is created in Intercom. **Is listing conversations part of the Intercom MCP functionality?** Yes, `list_conversations` provides a comprehensive list of all ongoing chats. This allows you to get an immediate overview of current support activity.