Manage contacts, conversations, companies, tickets, and help center articles in one place so your workflows stay aligned with the source of truth.
How to Use MCP Nodes
What is Intercom MCP?
Intercom MCP creates a customized node that understands how to work with your Intercom account. You can describe what you want in plain language, and the node will use the right Intercom tools to get it done, returning structured data you can pass to the next step. You simply prompt, the AI builds a purpose-built node, then you save and reuse it anywhere.What Can It Do for You?
- Find and manage contacts by name or email, then update details or status
- Search, retrieve, and update conversations by adding tags or replying
- Create and manage tickets, add comments, and list available ticket types
- Work with companies and help center articles to power support workflows
Available Tools
| Tool | What It Does | Example Use |
|---|---|---|
| Search Contacts | Search for contacts in Intercom by name or email | ”Find contacts matching name or email and return id, name, and email as structured data” |
| Update Contact | Update, archive, unarchive, or block an existing contact in Intercom | ”Given contact id, update attribute name to attribute value and return id and updated attributes” |
| Create Contact | Create a new contact in Intercom | ”Create a contact with name full name and email email and return id, name, and email” |
| Create Conversation | Create a new conversation in Intercom | ”Using contact id, start a conversation with message message body and return conversation id and state” |
| Reply To Conversation | Reply to an existing conversation in Intercom | ”Using conversation id, post a reply with reply body and return conversation id and reply id” |
| Update Conversation | Update a conversation by adding or removing tags, or attaching or detaching contacts | ”Given conversation id, add tag tag name and return conversation id and tags” |
| Search Conversations | Search for conversations in Intercom using various criteria | ”Search conversations matching search term and return conversation id, assignee, and state” |
| Retrieve Conversation | Retrieve a single conversation with all its details | ”Given conversation id, retrieve details and return conversation id, state, participants, and tags” |
| Search Companies | Search for companies in Intercom | ”Search companies matching company name or domain and return company id, name, and domain” |
| Retrieve Company | Retrieve a single company by its Intercom ID | ”Given company id, retrieve the company and return name, domain, and plan” |
| List Company Contacts | List all contacts that belong to a company | ”Using company id, list contacts and return contact ids, names, and emails” |
| Create Company | Create a new company in Intercom | ”Create a company with name company name and domain domain and return company id, name, and domain” |
| Associate Contact With Company | Associate a contact with a company | ”Given contact id and company id, associate them and return contact id and associated company ids” |
| List Articles | List help center articles | ”List help center articles and return article id, title, and url” |
| Retrieve Article | Get a specific help center article by ID | ”Given article id, retrieve the article and return title, state, and url” |
| Search Tickets | Search for tickets in Intercom using various criteria | ”Search tickets matching search term and return ticket id, title, and status” |
| Get Ticket | Get details of a specific support ticket | ”Given ticket id, return title, status, assignee, and priority” |
| Create Ticket | Create a new support ticket in Intercom | ”Create a ticket for contact id with title ticket title and description ticket description, then return ticket id and status” |
| Update Ticket | Update an existing support ticket in Intercom | ”Given ticket id, set status to status and return ticket id and status” |
| Add Comment To Ticket | Add a comment to an existing support ticket | ”Using ticket id, add the comment comment text and return ticket id and comment id” |
| Get Current Admin | Get information about the currently authenticated admin | ”Return the current admin’s id, name, and email as structured data” |
| List Tags | List all tags available in the Intercom workspace | ”List all tags and return id and name” |
| List Ticket Types | List all available ticket types in the Intercom workspace | ”List ticket types and return id and name” |
How to Use
1
Create Your Intercom MCP Node
Go to your node library, search for Intercom, and click “Create a node with AI”
2
Add Your Prompt
Drag the Intercom MCP node to your canvas and add your prompt in the text box.
3
Test Your Node
Run the node to see the results. If it looks good, you are all set. If you want to refine it, check the troubleshooting tips below.
4
Save and Reuse
Once your Intercom MCP node is working, save it to your library. You can now use this customized node in any workflow.
Example Prompts
Here are some prompts that work well with Intercom MCP: With tons of available tools, these examples showcase common use cases. Experiment with natural language to discover more possibilities. ContactsTroubleshooting
If your Intercom MCP node isn’t working as expected, try these best practices:Keep Prompts Simple and Specific
- Good: “Search companies for
company nameand return id and domain” - Bad: “Find
company name, list contacts, start a conversation with each usingmessage, and tag each conversation”
Match What Intercom Can Do
- Good: “Create a ticket for
contact idwith titleticket titleand descriptionticket descriptionand return ticket id and status” - Bad: “Create a ticket and email the customer a confirmation using
email template”
Break Complex Tasks Into Steps
Instead of trying to do everything in one prompt (which can cause timeouts or complexity issues):1
Step 1: Search Conversations
Search conversations matching
issue keyword and return conversation ids2
Step 2: Retrieve Conversation
Given
conversation id, retrieve details and return contact id and tags3
Step 3: Create Ticket
Using
contact id and ticket title, create a ticket and return ticket id and status4
Step 4: Add Comment To Ticket
Using
ticket id, add the comment comment text and return ticket id and comment idIn your workflow, connect these nodes sequentially. Use the conversation id from the search to retrieve the conversation and get the contact id, pass the contact id to create the ticket, then pass the ticket id to add the comment.
Focus on Data Retrieval
Intercom MCP is great at getting information from Intercom. For analysis or content creation, connect it to other nodes. Example:- Good prompt: “Given
ticket id, return title, status, assignee, and priority” - Bad prompt: “Given
ticket id, return details and also summarize the next steps”
Troubleshooting Node Creation
Empty Outputs
Empty Outputs
If you are seeing empty outputs in the node creation window (or if you have already created the node, hover over it and click “Edit”), use the chat interface to prompt the AI to add debug logs and verify the API response. You can also click the “Request changes” button in the node creation window to ask the AI to adjust logic or outputs.
Incorrect Results
Incorrect Results
In the node creation window (or if you have already created the node, hover over it and click “Edit”), use the chat interface to describe in detail what you expected versus what you received. You can also use the “Request changes” button in the node creation window to guide updates to filtering or output fields.
Errors
Errors
First click “Fix with Gummie”. If multiple attempts do not resolve it, simplify your prompt or contact support.
Iterate Using the Chat
Iterate Using the Chat
MCP node creation often benefits from a few tweaks. Use the chat interface in the node creation window to refine filters, output fields, or pagination. The AI will adjust the node based on your feedback.
Need More Help?
- Watch What are MCP Nodes video tutorial
- Check out MCP Best Practices in Gumloop University
- Join the Gumloop Community for support: https://forum.gumloop.com
- View the Intercom MCP setup guide for Claude and Cursor
- Contact support at support@gumloop.com
