Intercom

Intercom MCP Server for Cloudflare Workers

Available Tools

81 tools available in the Intercom MCP server. Each tool can be called by AI assistants to perform specific actions.

intercom_create_tag

Create a new tag.

Args:

name: Tag name

Returns: The created tag.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Tag name"
    }
  }
}

intercom_get_company

Get a single company by ID.

Args:

id: The company ID
format: Response format

Returns: The company record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Company ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_delete_contact

Delete a contact from Intercom.

Args:

id: Contact ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Contact ID to delete"
    }
  }
}

intercom_get_company_by_company_id

Get a single company by your external company_id.

Args:

company_id: Your external company ID
format: Response format

Returns: The company record.

{
  "type": "object",
  "required": [
    "company_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "company_id": {
      "type": "string",
      "description": "Your external company ID"
    }
  }
}

intercom_get_me

Get the currently authenticated admin.

Returns: The current admin record.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_list_admins

List all admins/teammates in the workspace.

Returns: List of all admins.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_get_admin

Get a single admin by ID.

Args:

id: The admin ID
format: Response format

Returns: The admin record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Admin ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_attach_contact_to_company

Attach a contact to a company.

Args:

contact_id: Contact ID
company_id: Company ID to attach

Returns: The company record.

{
  "type": "object",
  "required": [
    "contact_id",
    "company_id"
  ],
  "properties": {
    "company_id": {
      "type": "string",
      "description": "Company ID to attach"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID"
    }
  }
}

intercom_set_admin_away

Set an admin's away status.

Args:

admin_id: Admin ID
away_mode_enabled: Whether away mode is enabled
away_mode_reassign: Whether to reassign conversations

Returns: The updated admin record.

{
  "type": "object",
  "required": [
    "admin_id",
    "away_mode_enabled",
    "away_mode_reassign"
  ],
  "properties": {
    "admin_id": {
      "type": "string",
      "description": "Admin ID"
    },
    "away_mode_enabled": {
      "type": "boolean",
      "description": "Whether away mode is enabled"
    },
    "away_mode_reassign": {
      "type": "boolean",
      "description": "Whether to reassign conversations"
    }
  }
}

intercom_list_articles

List Help Center articles with pagination.

Args:

per_page: Number of articles to return (1-50, default: 20)
starting_after: Pagination cursor
format: Response format

Returns: Paginated list of articles.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "per_page": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1
    },
    "starting_after": {
      "type": "string"
    }
  }
}

intercom_get_article

Get a single article by ID.

Args:

id: The article ID
format: Response format

Returns: The article record with content.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Article ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_create_article

Create a new Help Center article.

Args:

title: Article title
author_id: Admin ID of the author
body: Article body content (HTML)
description: Article description
state: Article state ('published' or 'draft')
parent_id: Parent collection ID
parent_type: Type of parent ('collection' or 'section')

Returns: The created article.

{
  "type": "object",
  "required": [
    "title",
    "author_id"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Article body content (HTML)"
    },
    "state": {
      "enum": [
        "published",
        "draft"
      ],
      "type": "string",
      "default": "draft",
      "description": "Article state"
    },
    "title": {
      "type": "string",
      "description": "Article title"
    },
    "author_id": {
      "type": "string",
      "description": "Admin ID of the author"
    },
    "parent_id": {
      "type": "string",
      "description": "Parent collection ID"
    },
    "description": {
      "type": "string",
      "description": "Article description"
    },
    "parent_type": {
      "enum": [
        "collection"
      ],
      "type": "string",
      "description": "Type of parent (must be collection)"
    }
  }
}

intercom_update_article

Update an existing article.

Args:

id: Article ID to update
title: New article title
body: New article body content
description: New description
state: New article state
author_id: New author ID
parent_id: New parent collection ID
parent_type: New parent type

Returns: The updated article.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Article ID"
    },
    "body": {
      "type": "string"
    },
    "state": {
      "enum": [
        "published",
        "draft"
      ],
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "author_id": {
      "type": "string"
    },
    "parent_id": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "parent_type": {
      "enum": [
        "collection"
      ],
      "type": "string"
    }
  }
}

intercom_delete_article

Delete an article.

Args:

id: Article ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Article ID to delete"
    }
  }
}

intercom_search_articles

Search for articles by phrase.

Args:

phrase: Search phrase
state: Filter by state ('published' or 'draft')
help_center_id: Filter by Help Center ID
format: Response format

Returns: List of matching articles.

{
  "type": "object",
  "required": [
    "phrase"
  ],
  "properties": {
    "state": {
      "enum": [
        "published",
        "draft"
      ],
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "phrase": {
      "type": "string",
      "description": "Search phrase"
    },
    "help_center_id": {
      "type": "string"
    }
  }
}

intercom_list_collections

List Help Center collections with pagination.

Args:

per_page: Number of collections to return (1-50, default: 20)
starting_after: Pagination cursor
format: Response format

Returns: Paginated list of collections.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "per_page": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1
    },
    "starting_after": {
      "type": "string"
    }
  }
}

intercom_get_collection

Get a single collection by ID.

Args:

id: The collection ID
format: Response format

Returns: The collection record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Collection ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_create_collection

Create a new Help Center collection.

Args:

name: Collection name
description: Collection description
help_center_id: Help Center ID to add collection to

Returns: The created collection.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Collection name"
    },
    "description": {
      "type": "string",
      "description": "Collection description"
    },
    "help_center_id": {
      "type": "string",
      "description": "Help Center ID"
    }
  }
}

intercom_update_collection

Update an existing collection.

Args:

id: Collection ID to update
name: New collection name
description: New description

Returns: The updated collection.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Collection ID"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    }
  }
}

intercom_delete_collection

Delete a collection.

Args:

id: Collection ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Collection ID to delete"
    }
  }
}

intercom_archive_contact

Archive a contact in Intercom.

Args:

id: Contact ID to archive

Returns: The archived contact.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Contact ID to archive"
    }
  }
}

intercom_unarchive_contact

Unarchive a contact in Intercom.

Args:

id: Contact ID to unarchive

Returns: The unarchived contact.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Contact ID to unarchive"
    }
  }
}

intercom_list_companies

List companies from Intercom with pagination.

Args:

per_page: Number of companies to return (1-60, default: 50)
starting_after: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: Paginated list of companies.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "per_page": {
      "type": "integer",
      "default": 50,
      "maximum": 60,
      "minimum": 1,
      "description": "Number of companies to return"
    },
    "starting_after": {
      "type": "string",
      "description": "Pagination cursor"
    }
  }
}

intercom_scroll_companies

Scroll through all companies using cursor-based pagination.

Args:

scroll_param: Scroll cursor from previous response
format: Response format

Returns: List of companies with scroll_param for next page.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "scroll_param": {
      "type": "string",
      "description": "Scroll cursor from previous response"
    }
  }
}

intercom_create_or_update_company

Create a new company or update an existing one.

Args:

company_id: Your external company ID (required)
name: Company name
plan: Plan name
monthly_spend: Monthly spend amount
size: Number of employees
website: Company website URL
industry: Industry
custom_attributes: Custom attributes

Returns: The created or updated company.

{
  "type": "object",
  "required": [
    "company_id"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name"
    },
    "plan": {
      "type": "string",
      "description": "Plan name"
    },
    "size": {
      "type": "integer",
      "description": "Number of employees"
    },
    "website": {
      "type": "string",
      "description": "Company website URL"
    },
    "industry": {
      "type": "string",
      "description": "Industry"
    },
    "company_id": {
      "type": "string",
      "description": "Your external company ID (required)"
    },
    "monthly_spend": {
      "type": "number",
      "description": "Monthly spend amount"
    },
    "custom_attributes": {
      "type": "object",
      "description": "Custom attributes"
    }
  }
}

intercom_update_company

Update an existing company by Intercom ID.

Args:

id: Intercom company ID
name: New company name
plan: New plan name
monthly_spend: New monthly spend amount
size: New number of employees
website: New company website URL
industry: New industry
custom_attributes: Custom attributes to update

Returns: The updated company.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Intercom company ID"
    },
    "name": {
      "type": "string"
    },
    "plan": {
      "type": "string"
    },
    "size": {
      "type": "integer"
    },
    "website": {
      "type": "string"
    },
    "industry": {
      "type": "string"
    },
    "monthly_spend": {
      "type": "number"
    },
    "custom_attributes": {
      "type": "object"
    }
  }
}

intercom_delete_company

Delete a company from Intercom.

Args:

id: Company ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Company ID to delete"
    }
  }
}

intercom_list_company_contacts

List all contacts attached to a company.

Args:

company_id: Company ID
per_page: Number of contacts per page
format: Response format

Returns: Paginated list of contacts.

{
  "type": "object",
  "required": [
    "company_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "per_page": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1
    },
    "company_id": {
      "type": "string",
      "description": "Company ID"
    }
  }
}

intercom_list_company_segments

List all segments a company belongs to.

Args:

company_id: Company ID
format: Response format

Returns: List of segments.

{
  "type": "object",
  "required": [
    "company_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "company_id": {
      "type": "string",
      "description": "Company ID"
    }
  }
}

intercom_list_contacts

List contacts from Intercom with pagination.

Args:

per_page: Number of contacts to return (1-150, default: 50)
starting_after: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: Paginated list of contacts.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "per_page": {
      "type": "integer",
      "default": 50,
      "maximum": 150,
      "minimum": 1,
      "description": "Number of contacts to return"
    },
    "starting_after": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    }
  }
}

intercom_get_contact

Get a single contact by ID.

Args:

id: The contact ID
format: Response format

Returns: The contact record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Contact ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_create_contact

Create a new contact in Intercom.

Args:

role: Contact role ('user' or 'lead')
email: Email address
phone: Phone number
name: Full name
external_id: External ID from your system
custom_attributes: Custom attributes as JSON object

Returns: The created contact.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Full name"
    },
    "role": {
      "enum": [
        "user",
        "lead"
      ],
      "type": "string",
      "description": "Contact role"
    },
    "email": {
      "type": "string",
      "description": "Email address"
    },
    "phone": {
      "type": "string",
      "description": "Phone number"
    },
    "external_id": {
      "type": "string",
      "description": "External ID from your system"
    },
    "custom_attributes": {
      "type": "object",
      "description": "Custom attributes"
    }
  }
}

intercom_update_contact

Update an existing contact.

Args:

id: Contact ID to update
email: New email address
phone: New phone number
name: New full name
custom_attributes: Custom attributes to update

Returns: The updated contact.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Contact ID to update"
    },
    "name": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "custom_attributes": {
      "type": "object"
    }
  }
}

intercom_merge_contacts

Merge a lead contact into a user contact.

Args:

lead_id: ID of the lead contact (will be merged into user)
user_id: ID of the user contact (will be kept)

Returns: The merged contact.

{
  "type": "object",
  "required": [
    "lead_id",
    "user_id"
  ],
  "properties": {
    "lead_id": {
      "type": "string",
      "description": "Lead contact ID to merge from"
    },
    "user_id": {
      "type": "string",
      "description": "User contact ID to merge into"
    }
  }
}

intercom_search_contacts

Search for contacts using Intercom's search API.

Args:

field: Field to search on (e.g., 'email', 'name', 'role')
operator: Search operator ('=', '!=', 'IN', 'NIN', '>', '<', '~', '!~', '^', '$')
value: Value to search for
per_page: Number of results per page
format: Response format

Returns: Paginated list of matching contacts.

{
  "type": "object",
  "required": [
    "field",
    "operator",
    "value"
  ],
  "properties": {
    "field": {
      "type": "string",
      "description": "Field to search on"
    },
    "value": {
      "type": "string",
      "description": "Value to search for"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "operator": {
      "enum": [
        "=",
        "!=",
        "IN",
        "NIN",
        ">",
        "<",
        "~",
        "!~",
        "^",
        "$"
      ],
      "type": "string",
      "description": "Search operator"
    },
    "per_page": {
      "type": "integer",
      "default": 50,
      "maximum": 150,
      "minimum": 1
    }
  }
}

intercom_detach_contact_from_company

Detach a contact from a company.

Args:

contact_id: Contact ID
company_id: Company ID to detach

Returns: The company record.

{
  "type": "object",
  "required": [
    "contact_id",
    "company_id"
  ],
  "properties": {
    "company_id": {
      "type": "string",
      "description": "Company ID to detach"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID"
    }
  }
}

intercom_list_contact_companies

List all companies attached to a contact.

Args:

contact_id: Contact ID
format: Response format

Returns: List of companies attached to the contact.

{
  "type": "object",
  "required": [
    "contact_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID"
    }
  }
}

intercom_tag_contact

Add a tag to a contact.

Args:

contact_id: Contact ID
tag_id: Tag ID to add

Returns: The tag that was added.

{
  "type": "object",
  "required": [
    "contact_id",
    "tag_id"
  ],
  "properties": {
    "tag_id": {
      "type": "string",
      "description": "Tag ID to add"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID"
    }
  }
}

intercom_untag_contact

Remove a tag from a contact.

Args:

contact_id: Contact ID
tag_id: Tag ID to remove

Returns: The tag that was removed.

{
  "type": "object",
  "required": [
    "contact_id",
    "tag_id"
  ],
  "properties": {
    "tag_id": {
      "type": "string",
      "description": "Tag ID to remove"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID"
    }
  }
}

intercom_list_contact_notes

List all notes for a contact.

Args:

contact_id: Contact ID
per_page: Number of notes per page
format: Response format

Returns: Paginated list of notes.

{
  "type": "object",
  "required": [
    "contact_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "per_page": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID"
    }
  }
}

intercom_create_contact_note

Create a note for a contact.

Args:

contact_id: Contact ID
body: Note body content
admin_id: Admin ID creating the note (optional)

Returns: The created note.

{
  "type": "object",
  "required": [
    "contact_id",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Note body content"
    },
    "admin_id": {
      "type": "string",
      "description": "Admin ID creating the note"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID"
    }
  }
}

intercom_list_contact_segments

List all segments a contact belongs to.

Args:

contact_id: Contact ID
format: Response format

Returns: List of segments.

{
  "type": "object",
  "required": [
    "contact_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID"
    }
  }
}

intercom_list_contact_subscriptions

List all subscription types for a contact.

Args:

contact_id: Contact ID
format: Response format

Returns: List of subscription types.

{
  "type": "object",
  "required": [
    "contact_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID"
    }
  }
}

intercom_attach_subscription_to_contact

Subscribe a contact to a subscription type.

Args:

contact_id: Contact ID
subscription_id: Subscription type ID
consent_type: Type of consent ('opt_in', 'opt_out')

Returns: The subscription type.

{
  "type": "object",
  "required": [
    "contact_id",
    "subscription_id",
    "consent_type"
  ],
  "properties": {
    "contact_id": {
      "type": "string",
      "description": "Contact ID"
    },
    "consent_type": {
      "enum": [
        "opt_in",
        "opt_out"
      ],
      "type": "string",
      "description": "Type of consent"
    },
    "subscription_id": {
      "type": "string",
      "description": "Subscription type ID"
    }
  }
}

intercom_detach_subscription_from_contact

Unsubscribe a contact from a subscription type.

Args:

contact_id: Contact ID
subscription_id: Subscription type ID

Returns: The subscription type.

{
  "type": "object",
  "required": [
    "contact_id",
    "subscription_id"
  ],
  "properties": {
    "contact_id": {
      "type": "string",
      "description": "Contact ID"
    },
    "subscription_id": {
      "type": "string",
      "description": "Subscription type ID"
    }
  }
}

intercom_list_conversations

List conversations from Intercom with pagination.

Args:

per_page: Number of conversations to return (1-150, default: 20)
starting_after: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: Paginated list of conversations.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "per_page": {
      "type": "integer",
      "default": 20,
      "maximum": 150,
      "minimum": 1,
      "description": "Number of conversations to return"
    },
    "starting_after": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    }
  }
}

intercom_list_tags

List all tags in the workspace.

Returns: List of all tags.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_get_conversation

Get a single conversation by ID.

Args:

id: The conversation ID
format: Response format ('json' or 'markdown')

Returns: The conversation record with all messages.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Conversation ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_create_conversation

Create a new conversation.

Args:

user_id: ID of the user starting the conversation
body: Message body content

Returns: The created conversation.

{
  "type": "object",
  "required": [
    "user_id",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Message body content"
    },
    "user_id": {
      "type": "string",
      "description": "ID of the user"
    }
  }
}

intercom_reply_to_conversation

Reply to an existing conversation.

Args:

conversation_id: Conversation ID to reply to
message_type: Type of reply ('comment', 'note')
body: Reply body content
admin_id: Admin ID if replying as admin
attachment_urls: Array of attachment URLs (optional)

Returns: The updated conversation.

{
  "type": "object",
  "required": [
    "conversation_id",
    "message_type",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Reply body content"
    },
    "admin_id": {
      "type": "string",
      "description": "Admin ID if replying as admin"
    },
    "message_type": {
      "enum": [
        "comment",
        "note"
      ],
      "type": "string",
      "description": "Type of reply"
    },
    "attachment_urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Attachment URLs"
    },
    "conversation_id": {
      "type": "string",
      "description": "Conversation ID"
    }
  }
}

intercom_assign_conversation

Assign a conversation to an admin or team.

Args:

conversation_id: Conversation ID to assign
admin_id: Admin ID performing the assignment
assignee_id: Admin ID to assign the conversation to
body: Assignment message (optional)

Returns: The updated conversation.

{
  "type": "object",
  "required": [
    "conversation_id",
    "admin_id",
    "assignee_id"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Assignment message"
    },
    "admin_id": {
      "type": "string",
      "description": "Admin ID performing the assignment"
    },
    "assignee_id": {
      "type": "string",
      "description": "Admin ID to assign to"
    },
    "conversation_id": {
      "type": "string",
      "description": "Conversation ID"
    }
  }
}

intercom_snooze_conversation

Snooze a conversation until a specific time.

Args:

conversation_id: Conversation ID to snooze
admin_id: Admin ID performing the snooze
snoozed_until: Unix timestamp when to unsnooze

Returns: The snoozed conversation.

{
  "type": "object",
  "required": [
    "conversation_id",
    "admin_id",
    "snoozed_until"
  ],
  "properties": {
    "admin_id": {
      "type": "string",
      "description": "Admin ID"
    },
    "snoozed_until": {
      "type": "integer",
      "description": "Unix timestamp when to unsnooze"
    },
    "conversation_id": {
      "type": "string",
      "description": "Conversation ID"
    }
  }
}

intercom_open_conversation

Open a closed conversation.

Args:

conversation_id: Conversation ID to open
admin_id: Admin ID opening the conversation

Returns: The opened conversation.

{
  "type": "object",
  "required": [
    "conversation_id",
    "admin_id"
  ],
  "properties": {
    "admin_id": {
      "type": "string",
      "description": "Admin ID"
    },
    "conversation_id": {
      "type": "string",
      "description": "Conversation ID"
    }
  }
}

intercom_close_conversation

Close an open conversation.

Args:

conversation_id: Conversation ID to close
admin_id: Admin ID closing the conversation
body: Closing message (optional)

Returns: The closed conversation.

{
  "type": "object",
  "required": [
    "conversation_id",
    "admin_id"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Closing message"
    },
    "admin_id": {
      "type": "string",
      "description": "Admin ID"
    },
    "conversation_id": {
      "type": "string",
      "description": "Conversation ID"
    }
  }
}

intercom_search_conversations

Search for conversations using Intercom's search API.

Args:

field: Field to search on (e.g., 'source.author.id', 'state', 'open', 'read')
operator: Search operator ('=', '!=', 'IN', 'NIN', '>', '<', '~', '!~')
value: Value to search for
per_page: Number of results per page
format: Response format

Returns: Paginated list of matching conversations.

{
  "type": "object",
  "required": [
    "field",
    "operator",
    "value"
  ],
  "properties": {
    "field": {
      "type": "string",
      "description": "Field to search on"
    },
    "value": {
      "type": "string",
      "description": "Value to search for"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "operator": {
      "enum": [
        "=",
        "!=",
        "IN",
        "NIN",
        ">",
        "<",
        "~",
        "!~"
      ],
      "type": "string",
      "description": "Search operator"
    },
    "per_page": {
      "type": "integer",
      "default": 20,
      "maximum": 150,
      "minimum": 1
    }
  }
}

intercom_tag_conversation

Add a tag to a conversation.

Args:

conversation_id: Conversation ID
tag_id: Tag ID to add
admin_id: Admin ID adding the tag

Returns: The tag that was added.

{
  "type": "object",
  "required": [
    "conversation_id",
    "tag_id",
    "admin_id"
  ],
  "properties": {
    "tag_id": {
      "type": "string",
      "description": "Tag ID to add"
    },
    "admin_id": {
      "type": "string",
      "description": "Admin ID adding the tag"
    },
    "conversation_id": {
      "type": "string",
      "description": "Conversation ID"
    }
  }
}

intercom_untag_conversation

Remove a tag from a conversation.

Args:

conversation_id: Conversation ID
tag_id: Tag ID to remove
admin_id: Admin ID removing the tag

Returns: The tag that was removed.

{
  "type": "object",
  "required": [
    "conversation_id",
    "tag_id",
    "admin_id"
  ],
  "properties": {
    "tag_id": {
      "type": "string",
      "description": "Tag ID to remove"
    },
    "admin_id": {
      "type": "string",
      "description": "Admin ID removing the tag"
    },
    "conversation_id": {
      "type": "string",
      "description": "Conversation ID"
    }
  }
}

intercom_get_tag

Get a single tag by ID.

Args:

id: The tag ID
format: Response format

Returns: The tag record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Tag ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_list_data_attributes

List data attributes for a specific model.

Args:

model: The model to list attributes for ('contact', 'company', 'conversation')
format: Response format

Returns: List of data attributes.

{
  "type": "object",
  "properties": {
    "model": {
      "enum": [
        "contact",
        "company",
        "conversation"
      ],
      "type": "string",
      "description": "Model type"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_get_data_attribute

Get a single data attribute by ID.

Args:

id: The data attribute ID
format: Response format

Returns: The data attribute record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Data attribute ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_create_data_attribute

Create a new data attribute.

Args:

name: Attribute name
model: Model type ('contact', 'company', 'conversation')
data_type: Data type ('string', 'integer', 'float', 'boolean', 'date')
description: Attribute description
options: Options for list type (array of strings)

Returns: The created data attribute.

{
  "type": "object",
  "required": [
    "name",
    "model",
    "data_type"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Attribute name"
    },
    "model": {
      "enum": [
        "contact",
        "company",
        "conversation"
      ],
      "type": "string",
      "description": "Model type"
    },
    "options": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Options for list type"
    },
    "data_type": {
      "enum": [
        "string",
        "integer",
        "float",
        "boolean",
        "date"
      ],
      "type": "string",
      "description": "Data type"
    },
    "description": {
      "type": "string",
      "description": "Attribute description"
    }
  }
}

intercom_update_data_attribute

Update an existing data attribute.

Args:

id: Data attribute ID to update
description: New description
archived: Whether to archive the attribute
options: New options for list type

Returns: The updated data attribute.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Data attribute ID"
    },
    "options": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "archived": {
      "type": "boolean"
    },
    "description": {
      "type": "string"
    }
  }
}

intercom_list_data_events

List data events for a user.

Args:

type: Filter type (always 'user')
user_id: User ID to list events for (optional)
intercom_user_id: Intercom user ID (optional)
email: User email (optional)
format: Response format

Returns: List of data events.

{
  "type": "object",
  "properties": {
    "type": {
      "enum": [
        "user"
      ],
      "type": "string",
      "default": "user",
      "description": "Filter type"
    },
    "email": {
      "type": "string",
      "description": "User email"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "user_id": {
      "type": "string",
      "description": "User ID"
    },
    "intercom_user_id": {
      "type": "string",
      "description": "Intercom user ID"
    }
  }
}

intercom_create_data_event

Create a new data event.

Args:

event_name: Name of the event
user_id: User ID (optional)
intercom_user_id: Intercom user ID (optional)
email: User email (optional)
created_at: Unix timestamp of when event occurred (optional)
metadata: Event metadata as JSON object

Returns: Confirmation of event creation.

{
  "type": "object",
  "required": [
    "event_name"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "User email"
    },
    "user_id": {
      "type": "string",
      "description": "User ID"
    },
    "metadata": {
      "type": "object",
      "description": "Event metadata"
    },
    "created_at": {
      "type": "integer",
      "description": "Unix timestamp"
    },
    "event_name": {
      "type": "string",
      "description": "Event name"
    },
    "intercom_user_id": {
      "type": "string",
      "description": "Intercom user ID"
    }
  }
}

intercom_list_help_centers

List all Help Centers in the workspace.

Returns: List of all Help Centers.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_get_help_center

Get a single Help Center by ID.

Args:

id: The Help Center ID
format: Response format

Returns: The Help Center record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Help Center ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_create_message

Create and send a new message.

This can be used to send in-app messages or emails to users.

Args:

message_type: Type of message ('in_app', 'email')
subject: Message subject (required for email)
body: Message body content
template: Message template ('plain', 'personal')
from_admin_id: Admin ID to send from
to_type: Recipient type ('user', 'lead')
to_id: Recipient ID

Returns: The created message.

{
  "type": "object",
  "required": [
    "message_type",
    "body",
    "from_admin_id",
    "to_type",
    "to_id"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Message body content"
    },
    "to_id": {
      "type": "string",
      "description": "Recipient ID"
    },
    "subject": {
      "type": "string",
      "description": "Message subject (required for email)"
    },
    "to_type": {
      "enum": [
        "user",
        "lead"
      ],
      "type": "string",
      "description": "Recipient type"
    },
    "template": {
      "enum": [
        "plain",
        "personal"
      ],
      "type": "string",
      "default": "plain",
      "description": "Message template"
    },
    "message_type": {
      "enum": [
        "inapp",
        "email"
      ],
      "type": "string",
      "description": "Type of message"
    },
    "from_admin_id": {
      "type": "string",
      "description": "Admin ID to send from"
    }
  }
}

intercom_list_segments

List all segments in the workspace.

Args:

format: Response format

Returns: List of all segments.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_get_segment

Get a single segment by ID.

Args:

id: The segment ID
format: Response format

Returns: The segment record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Segment ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_list_subscription_types

List all subscription types in the workspace.

Returns: List of all subscription types.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_update_tag

Update an existing tag.

Args:

id: Tag ID to update
name: New tag name

Returns: The updated tag.

{
  "type": "object",
  "required": [
    "id",
    "name"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Tag ID"
    },
    "name": {
      "type": "string",
      "description": "New tag name"
    }
  }
}

intercom_delete_tag

Delete a tag.

Args:

id: Tag ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Tag ID to delete"
    }
  }
}

intercom_list_teams

List all teams in the workspace.

Returns: List of all teams.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_get_team

Get a single team by ID.

Args:

id: The team ID
format: Response format

Returns: The team record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Team ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_get_ticket

Get a single ticket by ID.

Args:

id: The ticket ID
format: Response format

Returns: The ticket record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Ticket ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_update_ticket

Update an existing ticket.

Args:

id: Ticket ID to update
ticket_attributes: Ticket attributes to update (JSON object)
state: New ticket state ('open', 'in_progress', 'waiting_on_customer', 'resolved')
assignment_admin_id: Admin ID to assign to
is_shared: Whether ticket is shared

Returns: The updated ticket.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Ticket ID"
    },
    "state": {
      "type": "string"
    },
    "is_shared": {
      "type": "boolean"
    },
    "ticket_attributes": {
      "type": "object",
      "description": "Ticket attributes"
    },
    "assignment_admin_id": {
      "type": "string",
      "description": "Admin ID to assign to"
    }
  }
}

intercom_reply_to_ticket

Reply to a ticket.

Args:

ticket_id: Ticket ID to reply to
message_type: Type of reply ('comment', 'note')
body: Reply body content
admin_id: Admin ID if replying as admin

Returns: The ticket part (reply).

{
  "type": "object",
  "required": [
    "ticket_id",
    "message_type",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Reply body content"
    },
    "admin_id": {
      "type": "string",
      "description": "Admin ID"
    },
    "ticket_id": {
      "type": "string",
      "description": "Ticket ID"
    },
    "message_type": {
      "enum": [
        "comment",
        "note"
      ],
      "type": "string",
      "description": "Type of reply"
    }
  }
}

intercom_search_tickets

Search for tickets using Intercom's search API.

Args:

field: Field to search on (e.g., 'ticket_state', 'created_at')
operator: Search operator ('=', '!=', 'IN', 'NIN', '>', '<')
value: Value to search for
per_page: Number of results per page
format: Response format

Returns: Paginated list of matching tickets.

{
  "type": "object",
  "required": [
    "field",
    "operator",
    "value"
  ],
  "properties": {
    "field": {
      "type": "string",
      "description": "Field to search on"
    },
    "value": {
      "type": "string",
      "description": "Value to search for"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "operator": {
      "enum": [
        "=",
        "!=",
        "IN",
        "NIN",
        ">",
        "<"
      ],
      "type": "string",
      "description": "Search operator"
    },
    "per_page": {
      "type": "integer",
      "default": 20,
      "maximum": 150,
      "minimum": 1
    }
  }
}

intercom_get_visitor

Get a visitor by ID.

Args:

id: Visitor ID
format: Response format

Returns: The visitor record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Visitor ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

intercom_update_visitor

Update a visitor's attributes.

Args:

id: Visitor ID to update
name: Visitor name
custom_attributes: Custom attributes to update

Returns: The updated visitor.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Visitor ID"
    },
    "name": {
      "type": "string",
      "description": "Visitor name"
    },
    "custom_attributes": {
      "type": "object",
      "description": "Custom attributes"
    }
  }
}

intercom_convert_visitor_to_contact

Convert a visitor to a user or lead contact.

Args:

visitor_id: Visitor ID to convert
type: Type to convert to ('user' or 'lead')
user_id: User ID to merge with (optional, for existing users)
email: Email address (optional)

Returns: The new contact.

{
  "type": "object",
  "required": [
    "visitor_id",
    "type"
  ],
  "properties": {
    "type": {
      "enum": [
        "user",
        "lead"
      ],
      "type": "string",
      "description": "Type to convert to"
    },
    "email": {
      "type": "string",
      "description": "Email address"
    },
    "user_id": {
      "type": "string",
      "description": "User ID to merge with"
    },
    "visitor_id": {
      "type": "string",
      "description": "Visitor ID to convert"
    }
  }
}