Skip to main content
Connect your Intercom workspace to quickly search, create, and update contacts, conversations, companies, tickets, and help center content from your automated workflows. Use natural language to pull exactly the fields you need, take action, and pass structured data into the next step of your process.
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

ToolWhat It DoesExample Use
Search ContactsSearch for contacts in Intercom by name or email”Find contacts matching name or email and return id, name, and email as structured data”
Update ContactUpdate, 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 ContactCreate a new contact in Intercom”Create a contact with name full name and email email and return id, name, and email”
Create ConversationCreate a new conversation in Intercom”Using contact id, start a conversation with message message body and return conversation id and state”
Reply To ConversationReply to an existing conversation in Intercom”Using conversation id, post a reply with reply body and return conversation id and reply id”
Update ConversationUpdate 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 ConversationsSearch for conversations in Intercom using various criteria”Search conversations matching search term and return conversation id, assignee, and state”
Retrieve ConversationRetrieve a single conversation with all its details”Given conversation id, retrieve details and return conversation id, state, participants, and tags”
Search CompaniesSearch for companies in Intercom”Search companies matching company name or domain and return company id, name, and domain”
Retrieve CompanyRetrieve a single company by its Intercom ID”Given company id, retrieve the company and return name, domain, and plan”
List Company ContactsList all contacts that belong to a company”Using company id, list contacts and return contact ids, names, and emails”
Create CompanyCreate 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 CompanyAssociate a contact with a company”Given contact id and company id, associate them and return contact id and associated company ids”
List ArticlesList help center articles”List help center articles and return article id, title, and url”
Retrieve ArticleGet a specific help center article by ID”Given article id, retrieve the article and return title, state, and url”
Search TicketsSearch for tickets in Intercom using various criteria”Search tickets matching search term and return ticket id, title, and status”
Get TicketGet details of a specific support ticket”Given ticket id, return title, status, assignee, and priority”
Create TicketCreate 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 TicketUpdate an existing support ticket in Intercom”Given ticket id, set status to status and return ticket id and status”
Add Comment To TicketAdd a comment to an existing support ticket”Using ticket id, add the comment comment text and return ticket id and comment id”
Get Current AdminGet information about the currently authenticated admin”Return the current admin’s id, name, and email as structured data”
List TagsList all tags available in the Intercom workspace”List all tags and return id and name”
List Ticket TypesList 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. Contacts
Find contacts matching `name or email` and return id, name, and email as structured data
Conversations
Using `conversation id`, add a reply with `reply body` and return conversation id and reply id
Tickets
Search tickets matching `search term` and return ticket id, title, and status
Companies
Search companies matching `company name or domain` and return company id, name, and domain
Help Center
List help center articles and return article id, title, and url
Create Ticket
Create a ticket for `contact id` with title `ticket title` and description `ticket description`, then return ticket id and status
Update Conversation
Given `conversation id`, add tag `tag name` and return conversation id and tags
List Company Contacts
Using `company id`, list company contacts and return contact ids, names, and emails
Start with search tools to get IDs, then run update or create actions. Keep prompts focused on one action, and ask for the exact fields you need. Save your best prompts as reusable nodes and chain them with Router or Google Sheets nodes for scale.

Troubleshooting

If your Intercom MCP node isn’t working as expected, try these best practices:

Keep Prompts Simple and Specific

  • Good: “Search companies for company name and return id and domain”
  • Bad: “Find company name, list contacts, start a conversation with each using message, and tag each conversation”
While this prompt might work, it is more efficient to break it into separate nodes. Intercom MCP works best with focused, single-action prompts.

Match What Intercom Can Do

  • Good: “Create a ticket for contact id with title ticket title and description ticket description and return ticket id and status”
  • Bad: “Create a ticket and email the customer a confirmation using email template
Intercom MCP excels at managing customer data, conversations, tickets, companies, contacts, and articles. For sending emails, combine it with the Gmail Sender and Gmail Reader nodes in your workflow.

Break Complex Tasks Into Steps

Instead of trying to do everything in one prompt (which can cause timeouts or complexity issues):
Search conversations matching `issue keyword`, create a ticket titled `ticket title` for `contact id`, add a comment `comment text`, and tag the conversation `tag name`
Break this into smaller, focused nodes that each handle one task:
1

Step 1: Search Conversations

Search conversations matching issue keyword and return conversation ids
2

Step 2: Retrieve Conversation

Given conversation id, retrieve details and return contact id and tags
3

Step 3: Create Ticket

Using contact id and ticket title, create a ticket and return ticket id and status
4

Step 4: Add Comment To Ticket

Using ticket id, add the comment comment text and return ticket id and comment id
In 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”
Use the Ask AI node for summarization or recommendations. Keep the Intercom node focused on retrieving or updating Intercom data, then pass the structured data to Ask AI for analysis.

Troubleshooting Node Creation

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.
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.
First click “Fix with Gummie”. If multiple attempts do not resolve it, simplify your prompt or contact support.
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?