manage_contacts
Create, update, archive, unarchive, merge, or delete contacts (users and leads) in Intercom.
Use **action** to specify the operation. Supports custom attributes and contact ownership assignment.
For merging, provide both a lead ID and a user ID — the lead will be merged into the user.
get_contact
Retrieve a single contact by their Intercom ID or external ID. Returns full contact details including custom attributes, tags, companies, and segments.
manage_articles
Create, update, or delete help center articles in Intercom. Articles power the help center and provide content for the Fin AI agent.
Supports multilingual content through translated content fields.
get_company
Retrieve a single company by its Intercom ID. Returns full company details including plan, custom attributes, and user count.
search_contacts
Search for contacts using Intercom's query language. Supports filtering by any contact field including custom attributes. Use nested AND/OR operators for complex queries.
Returns paginated results with cursor-based pagination.
manage_tickets
Create, update, or reply to Intercom tickets. Supports state transitions, assignment, and custom ticket attributes.
Use the "list_ticket_types" action to discover available ticket types before creating tickets.
search_conversations
Search and list conversations using Intercom's query language or list recent conversations with pagination.
Supports filtering by fields like source.author.id, state, read, priority, assignee, and more.
manage_conversations
Perform actions on Intercom conversations: create new conversations, reply, assign to teammates/teams, add notes, close, open, or snooze.
Combines multiple conversation management operations into a single tool.
send_message
Send an outbound message from an admin to a contact. Supports in-app and email messages.
The message will initiate a new conversation with the target contact.
search_articles
Search help center articles by phrase or list all articles with pagination. Search results include highlighted matching snippets.
manage_events
Submit or list custom data events for contacts. Data events track user activity and can trigger automations or be used for segmentation.
Use "submit" to track a new event, or "list" to retrieve events for a contact.
get_conversation
Retrieve a single conversation with full details including the source message and all conversation parts (replies, notes, assignments, etc.). Limited to 500 parts.
list_companies
List or filter companies in Intercom. Supports paginated listing and provider-supported filters for name, company_id, tag_id, and segment_id.
manage_companies
Create, update, or delete companies in Intercom. Also supports attaching or detaching contacts from companies.
The create and update operations use the same endpoint — if a company with the given companyId already exists, it will be updated.
manage_tags
Create, update, delete tags, and apply or remove tags from contacts and conversations.
Tags can be used to organize contacts, companies, and conversations for filtering and automation.
list_admins
List all admins (teammates) in the Intercom workspace. Useful for finding admin IDs needed for other operations like assigning conversations or sending messages.
create_note
Add an internal note to a contact's profile. Notes are visible only to teammates, not to the contact. Useful for recording internal context about a customer.
manage_data_attributes
List, create, update, or archive Intercom custom data attributes for contacts and companies. Data attributes define metadata fields used by contacts, companies, and conversations.
list_teams
List Intercom teams or retrieve a single team by ID. Teams are used as assignment targets for conversations and tickets.
get_notes
Retrieve an Intercom note by ID or list notes attached to a contact or company. Notes capture internal teammate context for customer records.
get_segments
List workspace segments, retrieve one segment, or list the segments attached to a contact. Segments group contacts by rules configured in Intercom.
manage_subscriptions
List subscription types and manage a contact's subscription preferences. Subscription types control opt-in and opt-out consent for non-essential communications.