> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rippit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Intercom

> Give the Rippit agent access to Intercom conversations, contacts, companies, and Help Center content.

Intercom is the connector to reach for when the question is about coverage: what customers are asking versus what your Help Center already answers.

## What the agent gets

* **Conversations**, searchable by source, author, state, tag, or date, with full message history on retrieval.
* **Contacts and companies**, including custom attributes, plan, and spend.
* **Help Center articles**, searchable by phrase and filterable by published or draft state.
* **Article drafting and updates, and internal notes on conversations**, if you enable the write tools.

Typical uses: finding which rising contact drivers have no article behind them, then drafting the articles; pulling the account context behind a set of escalating conversations.

If Intercom is already a Rippit integration, your conversations are in Rippit and you do not need this connector to analyze them. Connect Intercom when you want the agent to reach Help Center content, live contact and company records, or to write articles back.

## Setup

Intercom accepts either a workspace access token or OAuth. Neither needs setup in Intercom beyond generating the token, if you choose that path.

**Workspace access token (recommended for shared use).** Create one in Intercom and paste it into the connect dialog. It is stored encrypted and is not shown again.

**OAuth.** Click connect and sign in to Intercom.

Intercom's hosted MCP server supports US and EU-hosted workspaces only.

## Identity and scope

A workspace access token acts as the application rather than a person, org-wide, and does not break when someone leaves. That is the better fit for a connection a team relies on. When a write tool needs an author, Intercom attributes it per request.

OAuth acts as the authorizing user and sees what that user sees.

## Tools

| Tool                   | Access | What it does                                                                       |
| ---------------------- | ------ | ---------------------------------------------------------------------------------- |
| `search`               | Read   | Unified search across conversations and contacts                                   |
| `search_conversations` | Read   | Search conversations by ID, source, author, state, tag, or date                    |
| `get_conversation`     | Read   | Full conversation metadata plus complete message history                           |
| `search_contacts`      | Read   | Search contacts by ID, email, domain, name, phone, or attributes                   |
| `get_contact`          | Read   | Full contact profile, custom attributes, and last-seen data                        |
| `list_companies`       | Read   | List companies, filterable by name or external company ID                          |
| `get_company`          | Read   | Full company profile, monthly spend, user count, custom attributes                 |
| `search_articles`      | Read   | Search Help Center articles by phrase, state, or help center                       |
| `list_articles`        | Read   | List all Help Center articles with basic metadata                                  |
| `get_article`          | Read   | Full article content including HTML body, author, and timestamps                   |
| `fetch`                | Read   | Retrieve any Intercom resource by ID or URL                                        |
| `add_internal_note`    | Write  | Add an internal note to a conversation. Teammates only, never sent to the customer |
| `create_article`       | Write  | Create a Help Center article. Requires a title and an author ID                    |
| `update_article`       | Write  | Update an existing article's title, body, state, or author                         |
| `submit_mcp_feedback`  | Write  | Send feedback about the MCP server to Intercom                                     |

The eleven read tools are enabled by default. The write tools are not.