Intercom
OfficialEnables AI systems to access Intercom conversations, contacts, and customer data.
Tools (6)
search_conversations
Search for Intercom conversations using multiple filter criteria. Supports filtering by: - IDs: Search for specific conversation IDs - Source: Filter by source type (email, chat, etc.), author name/email - State: Filter by conversation state (open, closed, snoozed) - Assignment: Filter by team assignee ID or admin assignee ID - Statistics: Filter by response times and assignment metrics Pagination: - Results are paginated with up to 150 items per page (default 5) - If more results exist, the response includes a 'pages' object with 'pages.next.starting_after' cursor - To fetch the next page, make another request with the SAME search parameters plus the 'starting_after' value from the previous response - Continue until 'pages.next' is not present in the response Returns a list of matching conversations with basic details. Use get_conversation for full details.
get_conversation
Retrieve complete details for a specific Intercom conversation. Returns: - Full conversation metadata (state, priority, timestamps) - Complete message history with all conversation parts - Associated contacts and tags - Assignment and team information Accepted ID formats: - Raw conversation ID (e.g., 123456789) - Prefixed ID (e.g., conversation_123456789) - Intercom URL (e.g., https://app.intercom.com/a/inbox/_/inbox/conversation/123456789) Tip: If you copied the ID from a search or fetch result, remove the 'conversation_' prefix. This tool also accepts the prefixed form and URLs and will normalize automatically. Use this after search_conversations to get full conversation content.
search_contacts
Search for Intercom contacts using multiple filter criteria. Supports filtering by: - IDs: Search for specific contact IDs - Email/Domain: Filter by email address or domain - Name/Phone: Search by contact name or phone number - Custom Attributes: Filter by any custom data fields Pagination: - Results are paginated with up to 150 items per page (default 5) - If more results exist, the response includes a 'pages' object with 'pages.next.starting_after' cursor - To fetch the next page, make another request with the SAME search parameters plus the 'starting_after' value from the previous response - Continue until 'pages.next' is not present in the response Returns a list of matching contacts with their attributes. Use get_contact for additional details.
get_contact
Retrieve complete details for a specific Intercom contact. Returns: - Full contact profile (name, email, phone, location) - Role and signup information - Custom attributes and metadata - Last seen and activity timestamps Accepted ID formats: - Raw contact ID (UUID) - Prefixed ID (e.g., contact_aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee) - Intercom URL (e.g., https://app.intercom.com/a/apps/_/users/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee) Tip: If you copied the ID from a search or fetch result, remove the 'contact_' prefix. This tool also accepts the prefixed form and URLs and will normalize automatically. Use this after search_contacts to get full contact information.
search
Purpose: 1. Search for resources in Intercom (conversations and contacts) using a unified query approach. 2. Note that only a subset of properties will be returned in search results. 3. For complete details, use the Fetch tool with the returned IDs. Usage: 1. MUST specify object_type:conversations OR object_type:contacts to indicate which API to call. 2. Use specific field searches for precise filtering (e.g., email:john@example.com). 3. Use the starting_after parameter for pagination when more results exist. 4. Combine multiple search criteria with logical operators for complex queries. Search Tool Response: 1. Returns results with id, title, text, and url for each match. 2. IDs are prefixed with 'conversation_' or 'contact_' to indicate type. 3. Use these IDs with the Fetch tool to get complete resource details. Note: When filtering by id/contact_ids in queries, provide raw IDs without prefixes. If you pass prefixed IDs to get_conversation/get_contact, they are accepted and normalized. Intercom Search Query DSL specification: • Tokens separated by spaces • Each token: key[:op]:value • op (optional; default "eq") ∈ { eq, neq, gt, gte, lt, lte, in, nin, contains } • value: unquoted (alphanumeric, no spaces) or quoted in single/double quotes (to include spaces) Common Parameters: – object_type (mandatory) → "conversations" or "contacts" (specifies which API to call) – q/query → free-text search across key fields – created_at/updated_at → timestamp filters (YYYY-MM-DD or Unix timestamp) – limit → max results (default 10, max 150) – starting_after → pagination cursor CONVERSATION SEARCH (object_type:conversations): Supported fields: – id → raw conversation ID (no 'conversation_' prefix) – state → conversation state ("open", "closed", "snoozed") – priority → conversation priority ("priority", "not_priority") – source_type → conversation source type ("conversation", "email", "facebook", "twitter", etc.) – source_author_name → name of the message author – source_author_email → email of the message author – source_subject → subject line of the conversation – source_body → body content of the conversation – contact_ids → raw contact IDs (UUIDs) associated with the conversation (no 'contact_' prefix) – team_assignee_id → team ID assigned to the conversation – admin_assignee_id → admin ID assigned to the conversation – statistics_time_to_assignment → time to assignment in seconds – statistics_time_to_admin_reply → time to admin reply in seconds – statistics_time_to_first_close → time to first close in seconds CONTACT SEARCH (object_type:contacts): Supported fields: – id → raw contact ID (UUID, no 'contact_' prefix) – name → contact name – email → contact email address – email_domain → email domain – phone → contact phone number – role → contact role ("user", "lead") – custom_attributes.* → any custom attribute field (e.g., custom_attributes.company) EXAMPLES: user: show me recent conversations query: object_type:conversations created_at:gt:1735689600 user: find open conversations from email query: object_type:conversations state:open source_type:email user: search for conversations from support emails query: object_type:conversations source_author_email:contains:"@support" user: find conversations with slow response times query: object_type:conversations statistics_time_to_admin_reply:gt:3600 user: find conversations about billing query: object_type:conversations source_subject:contains:"billing" user: find conversations mentioning refund query: object_type:conversations source_body:contains:"refund" user: find contacts named John query: object_type:contacts name:"John" user: find contacts from example.com domain query: object_type:contacts email_domain:"example.com" user: find contacts with specific custom attribute query: object_type:contacts custom_attributes.plan_status:"active" user: recent contact activity query: object_type:contacts updated_at:gt:1735689600 limit:50 user: find conversations for a specific contact query: object_type:conversations contact_ids:in:d2e3bde8-4fe4-4a74-9232-5f7458e7a4cb user: find conversations assigned to a specific team query: object_type:conversations team_assignee_id:12345 user: find conversations assigned to a specific admin query: object_type:conversations admin_assignee_id:67890 Unsupported features: • Complex boolean logic beyond simple AND/OR • Fuzzy matching or proximity searches • Aggregations or analytics queries • Direct conversation content search (use source fields instead) • Real-time or streaming results
fetch
Retrieves detailed content for a specific resource identified by the given ID. Preferred input is an ID prefixed with 'conversation_' or 'contact_'. Also accepts Intercom URLs (e.g., app inbox conversation URLs or user profile URLs) and will parse the ID. For raw IDs without a prefix, use 'get_conversation' or 'get_contact'.