Intercom MCP integration

Add internal note

Add an internal note to an Intercom conversation. Notes are internal-only and never visible to the end user, and this tool cannot send customer-visible replies. Adding a note never changes the assignee. If the conversation is snoozed and assigned to someone other than the authenticated teammate, ad…

Create article

Create a new article in the Intercom Help Center. Required fields: - title: The article title - author_id: Numeric ID of the admin/teammate who authored the article Optional fields: - description: A short summary of the article - body: The article content in HTML format. Whitespace between block-le…

Fetch

Retrieve detailed content for a specific Intercom resource by ID or URL. Use this tool when you have: - A prefixed ID from search results (e.g., 'conversation_123456', 'contact_abc-def-123', or 'company_abc123') - An Intercom URL (e.g., 'https://app.intercom.com/a/inbox/_/inbox/conversation/123456'…

Get article

Retrieve complete details for a specific Intercom Help Center article. Returns: - Full article content including HTML body - Metadata: title, description, author, state - Timestamps: created_at, updated_at - Parent collection/section information - URL to view the article Use this after list_article…

Get company

Retrieve complete details for a specific Intercom company. Returns: - Full company profile (name, company_id, plan, industry, size) - Monthly spend and user count - All custom_attributes with their values (critical for attribute auditing) - Associated segments and tags - Activity timestamps (remote…

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_aaaa…

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…

List articles

List all articles in the Intercom Help Center. Returns a paginated list of articles with basic metadata. Pagination: - Uses page-based pagination (not cursor-based) - Default: page 1, 25 articles per page - Set 'per_page' (1–150) and 'page' to navigate results - Response includes 'pages' object wit…

List companies

List Intercom companies with optional filters. Supports: - name: Find a company by exact name match (returns a single company) - company_id: Find a company by its external company_id (returns a single company) - tag_id: Filter companies by tag ID - segment_id: Filter companies by segment ID Paginat…

Search

Purpose: 1. Search for resources in Intercom (conversations and contacts) using a unified query approach. For companies, use the list_companies tool. 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…

Search articles

Search for articles in the Intercom Help Center. Supports filtering by: - phrase: Free-text search across article title and body - state: Filter by 'published' or 'draft' - help_center_id: Filter articles by a specific Help Center (numeric ID) - highlight: When true, returns highlighted matching sn…

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: - Resul…