Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt

Use this file to discover all available pages before exploring further.

Intercom is a customer messaging platform for sales, marketing, and support. The Intercom MCP server lets you manage contacts, conversations, tickets, and help center content using natural language.

​
What Can It Do?

  • Search and manage contacts by name or email
  • Handle conversations with replies and tags
  • Create and update tickets for support workflows
  • Work with companies and help center articles

​
Where to Use It

Add Intercom as a tool to any agent. The agent can then manage your customer data conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add tools → Connect an app with MCP
  3. Search for the integration and select it
  4. Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

​
In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with Intercom tools. This gives you the flexibility of an agent within a deterministic workflow.

​
As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “Create a ticket for a billing issue”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

​
Available Tools

ToolDescription
Search ContactsSearch for contacts by name or email
Update ContactUpdate, archive, or block a contact
Create ContactCreate a new contact
Create ConversationStart a new conversation
Reply To ConversationReply to an existing conversation
Update ConversationAdd or remove tags
Search ConversationsSearch conversations by criteria
Search CompaniesSearch for companies
Create CompanyCreate a new company
List ArticlesList help center articles
Search TicketsSearch for tickets
Create TicketCreate a new support ticket
Update TicketUpdate ticket status
Add Comment To TicketAdd a comment to a ticket

​
Example Prompts

Use these with your agent or in the Agent Node: Find a contact: 
Find the contact with email john@company.com
Create a ticket: 
Create a support ticket for billing discrepancy for this contact
Search conversations: 
Find all open conversations tagged "urgent"
Update a ticket: 
Set the billing ticket status to in progress
Reply to conversation: 
Reply to the conversation saying we're looking into it

​
Troubleshooting

IssueSolution
Agent not finding the right dataUse specific emails or conversation IDs
Action not completingCheck that you’ve authenticated with Intercom
Unexpected resultsThe agent may chain multiple tools (e.g., finding a contact first, then creating a ticket). Review the agent’s reasoning to understand its approach.
Tool not availableVerify the tool is enabled in your agent’s MCP configuration
Agents are smart enough to chain multiple API calls together. For example, asking “Create a ticket for john@company.com” will find the contact first, then create the ticket. If results seem off, check the agent’s step-by-step reasoning.

​
Need Help?

Use this integration directly in Claude or Cursor. Connect remotely via the Intercom MCP server using your Gumloop credentials.