Intercom

Live

OAUTH 2.0

CUSTOMER SUPPORT

Customer Support

Every customer conversation, contact, and support ticket your team handles lives in Intercom. Intercom MCP gives your agent authenticated access to customer data scoped to the user who authorized it.

  • Acts as the user: Access and write actions stay tied to the Intercom account that authorized the agent.
  • Credentials stay vaulted: AES-256, resolved at request time, never in LLM context.
  • Scoped before every call: User permissions enforced. 90-day audit trail.
Intercom
agent · Acme Q3
Run
List all open high-priority conversations unassigned for more than 4 hours.
S
intercom_conversations_list
79ms
Support agent
7 open conversations unassigned 4+ hours. Top: billing dispute (6h, $2K account), login loop bug (5h, enterprise), API key reset (4.5h), data export failure (4.5h), onboarding stuck (4h).
Sources: 7 open conversations, unassigned
intercommcp
7 conversations
18:29
Message Claude...

Tools your support agent reaches for on Intercom, scoped per user.

CALL ANY TOOL
List and reply to conversations, search contacts, assign tickets, and retrieve full message history.
intercom_list_tags
List tags
List all tags in the Intercom workspace.
Parameters
Name
Type
Required
Description
schema_version
string
Optional
Schema version
tool_version
string
Optional
Tool version
intercom_search_tickets
Search tickets
intercom_list_teams
List teams
intercom_search_articles
Search articles
intercom_list_admins
List admins
intercom_search_contacts
Search contacts
intercom_list_macros
List macros
intercom_search_conversations
Search conversations
intercom_list_articles
List articles
intercom_search_activity_logs
Search activity logs
intercom_list_contacts
List contacts
intercom_get_macro
Get macro
intercom_list_segments
List segments
intercom_create_ticket
Create ticket
intercom_list_companies
List companies
intercom_update_ticket
Update ticket
intercom_list_newsfeeds
List newsfeeds
intercom_create_article
Create article
intercom_list_conversations
List conversations
intercom_create_contact
Create contact
intercom_list_news_items
List news items
intercom_create_message
Create message
intercom_list_data_events
List data events
intercom_update_article
Update article
intercom_list_contact_tags
List contact tags
intercom_update_company
Update company
intercom_list_help_centers
List help centers
intercom_update_contact
Update contact
intercom_list_ticket_types
List ticket types
intercom_update_visitor
Update visitor
Build your Agent
Drop the toolkit in, point it at the user, and your support agent can use Intercom from the first run.
Python · LlamaIndex
import { ScalekitClient } from "@scalekit-sdk/node";
import { DynamicStructuredTool } from "@langchain/core/tools";
import { createReactAgent } from "@langchain/langgraph/prebuilt";
import { z } from "zod";

const sk = new ScalekitClient(envUrl, clientId, clientSecret);

const { tools } = await sk.tools.listScopedTools("user_123", {
filter: { connectionNames: ["intercom"], toolNames: ["intercom_conversations_list", "intercom_conversation_get", "intercom_conversation_reply"] },
pageSize: 100,
});

const lcTools = tools.map((t) => new DynamicStructuredTool({
name: t.tool.definition.name,
description: t.tool.definition.description,
schema: z.object({}).passthrough(),
func: async (args) => {
const { data } = await sk.tools.executeTool({
toolName: t.tool.definition.name,
identifier: "user_123",
params: args,
});
return JSON.stringify(data);
},
}));

const agent = createReactAgent({ llm, tools: lcTools });
import { ScalekitClient } from "@scalekit-sdk/node";
import OpenAI from "openai";

const sk = new ScalekitClient(envUrl, clientId, clientSecret);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
filter: { connectionNames: ["intercom"], toolNames: ["intercom_conversations_list", "intercom_conversation_get", "intercom_conversation_reply"] },
pageSize: 100,
});

const llmTools = tools.map((t) => ({
type: "function",
function: {
name: t.tool.definition.name,
description: t.tool.definition.description,
parameters: t.tool.definition.input_schema,
},
}));

const resp = await openai.responses.create({
model: "gpt-4o", input: prompt, tools: llmTools,
});
import { ScalekitClient } from "@scalekit-sdk/node";
import Anthropic from "@anthropic-ai/sdk";

const sk = new ScalekitClient(envUrl, clientId, clientSecret);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
filter: { connectionNames: ["intercom"], toolNames: ["intercom_conversations_list", "intercom_conversation_get", "intercom_conversation_reply"] },
pageSize: 100,
});

const llmTools = tools.map((t) => ({
name: t.tool.definition.name,
description: t.tool.definition.description,
input_schema: t.tool.definition.input_schema,
}));

const msg = await anthropic.messages.create({
model: "claude-sonnet-4-6", max_tokens: 1024,
tools: llmTools,
messages: [{ role: "user", content: prompt }],
});
import { Agent } from "@google/adk/agents";
import {
MCPToolset, StreamableHTTPConnectionParams,
} from "@google/adk/tools/mcp";

const toolset = new MCPToolset({
connectionParams: new StreamableHTTPConnectionParams({
url: "https://mcp.scalekit.com/intercom",
headers: { Authorization: `Bearer ${userScopedToken}` },
}),
});

const agent = new Agent({
name: "agent", model: "gemini-2.0-flash",
tools: await toolset.getTools(),
});
Try these prompts
Paste any prompt into your agent to start using Intercom.
Triage & escalation
Copy the prompt
Copied
List all open conversations unassigned for 4+ hours.
Copy the prompt
Copied
Find conversations from [account name].
Copy the prompt
Copied
Show me all conversations tagged [tag].
Copy the prompt
Copied
Which conversations are snoozed until today?
Action & replies
Copy the prompt
Copied
Reply to conversation [id]: [text].
Copy the prompt
Copied
Assign conversation [id] to [admin].
Copy the prompt
Copied
Add a private note to [conversation id]: [note].
Copy the prompt
Copied
Close conversation [id] with reason [reason].
Contacts & reporting
Copy the prompt
Copied
Search contacts by email [email].
Copy the prompt
Copied
Get conversation history for [contact].
Copy the prompt
Copied
How many open conversations by team?
Copy the prompt
Copied
List conversations with CSAT score below 3.
SEE HOW AUTH WORKS
Users authorize Intercom once. Their credentials stay vaulted, every call is checked, and every action is logged.
1
Authorize
Your user connects
Intercom
once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access
Who:
user ‘A’
when:
Once per user
access:
Limited to user
2
Store
Their
Intercom
token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection
vault:
encrypted
scope:
per-user
tokens:
auto-refreshed
3
Resolve
When your agent calls a
Intercom
tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs
speed:
~40ms
check:
before every call
seen by:
nobody
4
Audit
Every
Intercom
tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it
history:
90 days
export:
SIEM-ready
logged:
every call
Test other agents
Same per-user auth pattern across other support agents and MCP connectors. Working code, live demos, fork what fits.
Support and Ops Teams
Support triage agent
Fetches new Zendesk tickets, classifies them by type and urgency, searches the Notion knowledge base for an answer, and routes what it cannot resolve to Slack. Every call runs on the support agent's own delegated OAuth.
Support and Ops Teams
Support ticket automation agent
Fetches new Zendesk tickets, drafts a reply from Notion knowledge base articles, digests what it cannot answer to Slack, and archives the rest, acting as the support agent rather than a shared API key.
Support and Ops Teams
Freshdesk CSAT agent
Watches Freshdesk for resolved tickets, emails each requester a CSAT survey from Gmail, and writes the score and the verbatim back onto the ticket, every call on the support rep's own delegated OAuth.
Engineering Teams
Slack triage
Polls Slack for new messages, classifies bugs and support requests with a LangGraph router, files GitHub issues or Zendesk tickets, and confirms in the thread.
Test other agents
Same per-user auth pattern across other support agents and MCP connectors. Working code, live demos, fork what fits.
SUPPORT
Support ticket automation (Google ADK)
Fetch, annotate, and archive Zendesk tickets with Notion context, digesting anything it cannot answer to Slack.
SUPPORT
Support triage agent
Classify new Zendesk tickets, search the Notion knowledge base for an answer, and route what it cannot resolve to Slack.
SUPPORT
Freshdesk CSAT follow-up agent
Spot resolved Freshdesk tickets, email the CSAT survey from Gmail, and write the score back onto the ticket.
ENGINEERING
Slack triage agent
Classify new Slack messages as bugs or support requests, file the GitHub issue or Zendesk ticket, and reply in the thread.
Why Scalekit
Secure your agent's access. Connectors ship in minutes
01.
Shared tokens break per-user analytics
A shared token looks fine in a demo. In production every call looks like a service account. Scalekit resolves the real user credential so attribution, audit, and scope stay accurate.
// shared token
 audit → bot_service_account
 user_filter → broken

 // scalekit
 audit → user_abc
 scope → enforced ✓
02.
Authentication is not authorization
03.
Multi-tenancy is architectural
04.
Intercom today. Others tomorrow.
“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”
Venu Madhav Kattagoni
Head of Engineering / Von
FAQs
Frequently Asked Questions
Does the agent access Intercom as the user or as a shared key?
As the user. Each workspace member authorizes once and Scalekit resolves their credential at request time. Audit logs attribute every action to that user, not a shared service account.
Where is the Intercom oauth 2.0 stored?
In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Tokens never appear in prompts, logs, or LLM context.
Can I limit what the agent is allowed to do in Intercom?
Yes. Pass a tool name filter to listScopedTools so the support agent only sees the subset you authorize. Pre-API-call scope checks block out-of-policy actions before the request reaches Intercom.
What happens when a user revokes Intercom access?
The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.
Can the agent reply to conversations assigned to other agents?
Depends on the authorizing user's Intercom role. Admins can send from any inbox; agents typically operate on their own assigned conversations. Team permissions and assignment rules apply at every call.
Start in your coding agent
Up and running in one command
Install the Scalekit skill in your editor of choice. Connector, auth, tools, prompt, all wired up
Claude Code REPL
/plugin marketplace add scalekit-inc/claude-code-authstack
/plugin install agentkit@scalekit-auth-stack
Cursor Code REPL
# ~/.cursor/mcp.json
{
""mcpServers"": {
""intercom"": {
""url"": ""https://mcp.scalekit.com/intercom"",
""headers"": { ""Authorization"": ""Bearer $SCALEKIT_TOKEN"" }
}
}
}
Codex Code REPL
# ~/.codex/config.toml
[mcp_servers.intercom]
url = ""https://mcp.scalekit.com/intercom""
auth_env = ""SCALEKIT_TOKEN""
Copilot Code REPL
# .vscode/mcp.json
{
""servers"": {
""intercom"": {
""url"": ""https://mcp.scalekit.com/intercom"",
""type"": ""http""
}
}
}