# How to connect Intercom to AI agents?

Connect Intercom to Sequel with OAuth and ask about conversations, support volume, response times, and customers in plain English.

Connect **Intercom** to Sequel and ask about your support conversations, tickets, response times, and customers in plain English — from the Sequel app or any MCP/AI client wired up to the [MCP server](/docs/install). Then join it with your product or revenue data for questions a single tool can't answer alone.

## What you'll need

- An **Intercom account** with access to the workspace you want to query.
- Permission to authorize an OAuth app for that workspace (typically a workspace admin).

Intercom connects over **OAuth**, so there's no key to copy or paste — you authorize Sequel with your Intercom account and the workspace is detected automatically. The tokens Sequel receives are **read-only** and don't expire.

## Connect it

<Steps>
<Step title="Open a new connection">
In the Sequel dashboard, go to **Connections → New connection** and choose **Intercom**.
</Step>

<Step title="Connect with Intercom">
You'll be redirected to Intercom's authorization screen (`app.intercom.com/oauth`). Sign in and approve access for the workspace you want Sequel to query.
</Step>

<Step title="Confirm">
Sequel exchanges the code, reads your workspace from Intercom's `/me` endpoint, and names the connection after it (e.g. *Intercom — Acme Support*). The connection goes live once access is verified.
</Step>
</Steps>

<Callout type="info" title="One workspace per connection">
Each connection maps to a single Intercom workspace. To query another workspace, repeat the flow and authorize that one.
</Callout>

## What you can query

Sequel exposes read access to your Intercom workspace through these tools:

- **Conversations** — search by open/closed state, assignee, team, tags, priority, source, and reply-time statistics.
- **Tickets** — filter by ticket state, category, type, and assignee.
- **Contacts** — users and leads, by email, role, signup/last-seen dates, or any custom attribute.
- **Companies** — full export with plan, spend, session and user counts, size, and industry.
- **Tags, Teams, and Admins** — small lookups, handy for resolving names to ids before a search.

## Try it

- "How many conversations were opened last week, and how many are still open?"
- "What's our median time to first reply this month, by team?"
- "List contacts that signed up in the last 30 days but haven't been seen since."
- "Which companies have the highest monthly spend?"

<Callout type="info" title="Timestamps are Unix seconds">
Intercom returns all dates as Unix seconds. Just ask in plain language — Sequel handles the conversion.
</Callout>

## Join it with other sources

Intercom gets more powerful alongside your other data. With a database also connected, ask:

> "For accounts with an open Intercom ticket this week, what's their MRR in our Postgres `subscriptions` table?"

## Troubleshooting

| Symptom | Likely fix |
| --- | --- |
| Authorization fails | Re-run the OAuth flow and approve access for the correct workspace; make sure your Intercom user can authorize apps. |
| Wrong workspace connected | You authorized a different workspace — start a new connection and pick the right one on Intercom's screen. |
| "Rate limit" errors on large pulls | Intercom caps search at 150 rows per page; narrow the date range or let Sequel page through with the cursor. |

## Related

- [Connecting your first data source](/docs/connecting-your-first-data-source)
- [Chatting with your data](/docs/chatting-with-your-data)
- [Browse all integrations](/docs/integrations)