Intercom API MCP server
Contacts, companies, conversations, tickets and articles.
The Intercom REST API (2.11): contacts and companies, conversations and replies, tickets, articles and help center, tags, segments, data attributes, events, admins and teams, with an access token.
Why use the hosted one: Every endpoint of Intercom's API behind the gateway's search, with your own Intercom access token stored encrypted and sent only to Intercom.
Needs your Intercom access token: add it once in the dashboard (get one at Intercom). It is stored encrypted and sent only to that API.
Connect
claude mcp add --transport http hj-intercom-api https://mcp.hjlabs.in/mcp/intercom-api \
--header "Authorization: Bearer YOUR_API_KEY"Create an API key and put it in place of YOUR_API_KEY. Step-by-step guides: claude.ai and ChatGPT connectors, Claude Code, Cursor, VS Code, Claude Desktop, Windsurf, Zed, OpenAI Codex CLI, Gemini CLI.
All 108 tools
List 24 tools
- List all activity logs
list_activity_logs - List all admins
list_admins - List all articles
list_articles - List all collections
list_all_collections - List all Help Centers
list_help_centers - List attached contacts
list_attached_contacts - List attached segments for companies
list_attached_segments_for_companies - List all companies
list_all_companies - List attached companies for contact
list_companies_for_acontact - List all notes
list_notes - List attached segments for contact
list_segments_for_acontact - List subscriptions for a contact
list_subscriptions_for_acontact - List tags attached to a contact
list_tags_for_acontact - List all contacts
list_contacts - List all conversations
list_conversations - List all data attributes
list_data_attributes - List all news items
list_news_items - List all live newsfeed items
list_live_newsfeed_items - List all newsfeeds
list_newsfeeds - List all segments
list_segments - List subscription types
list_subscription_types - List all tags
list_tags - List all teams
list_teams - List all ticket types
list_ticket_types
Create 16 tools
- Create an article
create_article - Create a collection
create_collection - Create or Update a company
create_or_update_company - Create a note
create_note - Create contact
create_contact - Creates a conversation
create_conversation - Create a data attribute
create_data_attribute - Submit a data event
create_data_event - Create content data export
create_data_export - Create a message
create_message - Create a news item
create_news_item - Create a phone Switch
create_phone_switch - Create or update a tag, Tag or untag companies, Tag contacts
create_tag - Create a new attribute for a ticket type
create_ticket_type_attribute - Create a ticket type
create_ticket_type - Create a ticket
create_ticket
Retrieve 13 tools
- Retrieve an admin
retrieve_admin - Retrieve an article
retrieve_article - Retrieve a collection
retrieve_collection - Retrieve a Help Center
retrieve_help_center - Retrieve companies
retrieve_company - Retrieve a company by ID
retrieve_acompany_by_id - Retrieve a conversation
retrieve_conversation - Retrieve a news item
retrieve_news_item - Retrieve a newsfeed
retrieve_newsfeed - Retrieve a note
retrieve_note - Retrieve a segment
retrieve_segment - Retrieve a team
retrieve_team - Retrieve a visitor with User ID
retrieve_visitor_with_user_id
Update 11 tools
- Update an article
update_article - Update a collection
update_collection - Update a company
update_company - Update a contact
update_contact - Update a conversation
update_conversation - Update a data attribute
update_data_attribute - Update a news item
update_news_item - Update an existing attribute for a ticket type
update_ticket_type_attribute - Update a ticket type
update_ticket_type - Update a ticket
update_ticket - Update a visitor
update_visitor
Attach 6 tools
- Attach a Contact to a Company
attach_contact_to_acompany - Add subscription to a contact
attach_subscription_type_to_contact - Add tag to a contact
attach_tag_to_contact - Add tag to a conversation
attach_tag_to_conversation - Attach a contact to a conversation
attach_contact_to_conversation - Add tag to a ticket
attach_tag_to_ticket
Delete 6 tools
- Delete an article
delete_article - Delete a collection
delete_collection - Delete a company
delete_company - Delete a contact
delete_contact - Delete a news item
delete_news_item - Delete tag
delete_tag
Detach 6 tools
- Detach a contact from a company
detach_contact_from_acompany - Remove subscription from a contact
detach_subscription_type_to_contact - Remove tag from a contact
detach_tag_from_contact - Remove tag from a conversation
detach_tag_from_conversation - Detach a contact from a group conversation
detach_contact_from_conversation - Remove tag from a ticket
detach_tag_from_ticket
Search 4 tools
- Search for articles
search_articles - Search contacts
search_contacts - Search conversations
search_conversations - Search tickets
search_tickets
Get 3 tools
- Show content data export
get_data_export - Retrieve a ticket type
get_ticket_type - Retrieve a ticket
get_ticket
Convert 2 tools
- Convert a conversation to a ticket
convert_conversation_to_ticket - Convert a visitor
convert_visitor
Reply 2 tools
- Reply to a conversation
reply_conversation - Reply to a ticket
reply_ticket
Archive 1 tool
- Archive contact
archive_contact
Auto 1 tool
- Run Assignment Rules on a conversation
auto_assign_conversation
Cancel 1 tool
- Cancel content data export
cancel_data_export
Data 1 tool
- Create event summaries
data_event_summaries
Download 1 tool
- Download content data export
download_data_export
Find 1 tool
- Find a specific tag
find_tag
Identify 1 tool
- Identify an admin
identify_admin
Lis 1 tool
- List all data events
lis_data_events
Manage 1 tool
- Manage a conversation
manage_conversation
Merge 1 tool
- Merge a lead and a user
merge_contact
Redact 1 tool
- Redact a conversation part
redact_conversation
Scroll 1 tool
- Scroll over all companies
scroll_over_all_companies
Set 1 tool
- Set an admin to away
set_away_admin
Show 1 tool
- Get a contact
show_contact
Unarchive 1 tool
- Unarchive contact
unarchive_contact
Try asking
Find open conversations assigned to me and summarise what each customer wants.
Usage and limits
Every account gets a free daily allowance of tool calls; connecting, listing and searching are not counted. See the limits. Only a tool that runs costs a call.