Intercom MCP server for AI agents

Search and update Intercom contacts, read and answer conversations and tickets, send messages, tag, assign and close, and search help center articles.

IntercomBEARER_TOKENOAUTH2

Runs with your users' own Intercom accounts. Credentials stay on prompt-tm.com.

24 tools · 0 triggers

Auth
Access token · OAuth 2.0 (sign in with the app)
Tools
24
Triggers
0
Category
Communication, CRM
Connect Intercom www.intercom.com

Tools and triggers

  • Get the current admin

    INTERCOM_IDENTIFY_ADMIN

    Returns the admin the token belongs to (ID, name, email, team IDs) and their workspace (`app`).read-only

  • List admins

    INTERCOM_LIST_ADMINS

    Lists the workspace's admins (teammates) with ID, name, email and away status. Admin IDs are needed to reply, assign and tag.read-only

  • List teams

    INTERCOM_LIST_TEAMS

    Lists the workspace's teams with their IDs, names and admin IDs.read-only

  • Search contacts

    INTERCOM_SEARCH_CONTACTS

    Finds contacts (users and leads) by their attributes, such as email, name, creation date or a custom attribute. Recently created contacts can take a few minutes to show up.read-only

  • Get a contact

    INTERCOM_SHOW_CONTACT

    Returns a contact with its attributes, location, tags, companies and notes summary.read-only

  • Create a contact

    INTERCOM_CREATE_CONTACT

    Creates a user or lead. Give at least one of `email`, `external_id` or `role`.

  • Update a contact

    INTERCOM_UPDATE_CONTACT

    Changes a contact's attributes. Only the fields you pass change.destructive

  • List contact notes

    INTERCOM_LIST_NOTES

    Lists the notes teammates left on a contact.read-only

  • Add a note to a contact

    INTERCOM_CREATE_NOTE

    Adds an internal note to a contact. Contacts never see notes.

  • Tag a contact

    INTERCOM_ATTACH_TAG_TO_CONTACT

    Adds an existing tag to a contact and returns the tag.

  • Search conversations

    INTERCOM_SEARCH_CONVERSATIONS

    Finds conversations by their attributes, such as `state`, `open`, `admin_assignee_id`, `team_assignee_id`, `created_at` or `source.body`.read-only

  • Get a conversation

    INTERCOM_RETRIEVE_CONVERSATION

    Returns a conversation with its parts: messages, replies, notes and assignment changes, up to the 500 most recent.read-only

  • Reply to a conversation

    INTERCOM_REPLY_CONVERSATION

    Replies to a conversation as an admin (a reply the contact sees, or an internal `note`) or on behalf of the contact.

  • Close, snooze, open or assign a conversation

    INTERCOM_MANAGE_CONVERSATION

    Changes a conversation's state: `close` it, `snoozed` until a time, `open` it again, or `assignment` to an admin or team.

  • Send a message

    INTERCOM_CREATE_MESSAGE

    Sends a new message from an admin to a contact, in the app or by email. With `create_conversation_without_contact_reply` it opens a conversation in the inbox right away.

  • Tag a conversation

    INTERCOM_ATTACH_TAG_TO_CONVERSATION

    Adds an existing tag to a conversation and returns the tag.

  • Search tickets

    INTERCOM_SEARCH_TICKETS

    Finds tickets by their attributes, such as `state`, `open`, `ticket_type_id`, `admin_assignee_id`, `created_at` or a ticket attribute.read-only

  • Get a ticket

    INTERCOM_GET_TICKET

    Returns a ticket with its type, state, attributes, contacts and assignment.read-only

  • Create a ticket

    INTERCOM_CREATE_TICKET

    Creates a ticket of a given ticket type for one contact. Set the title and description in `ticket_attributes` as `_default_title_` and `_default_description_`.

  • Reply to a ticket

    INTERCOM_REPLY_TICKET

    Replies to a ticket as an admin (a reply the contact sees, or an internal `note`) or on behalf of the contact.

  • Update a ticket

    INTERCOM_UPDATE_TICKET

    Changes a ticket: its state, attributes, assignee, company, sharing or snooze time. Set `open: false` to close it.destructive

  • List tags

    INTERCOM_LIST_TAGS

    Lists the workspace's tags with their IDs and names.read-only

  • Search help center articles

    INTERCOM_SEARCH_ARTICLES

    Searches help center articles for a phrase and returns the matches, optionally with highlighted snippets.read-only

  • Get an article

    INTERCOM_RETRIEVE_ARTICLE

    Returns a help center article: title, description, body (HTML), author, state, URL, tags and translated content.read-only

Try Intercom now

Sign in, connect your account and run any of these in the playground, or ask your agent through the router.

Try it free

Connect via MCP

Create an MCP server for Intercom in the dashboard, then add its URL to your client. This is the Claude Code command; the client guide has the others.

terminal
claude mcp add --transport http intercom \
  "https://www.prompt-tm.com/mcp/<server id>?user_id=<your user>" \
  --header "x-api-key: ptm_…"

Connect via REST

Run a tool with one request. The response is { data, error, successful, log_id } for every tool.

terminal
curl -X POST https://www.prompt-tm.com/api/v3/tools/execute/INTERCOM_IDENTIFY_ADMIN \
  -H "x-api-key: $PROMPT_TM_KEY" -H "content-type: application/json" \
  -d '{ "user_id": "alice", "arguments": {} }'

Intercom questions

Other toolkits