Intercom Remote MCP Server
Intercom's hosted MCP exposes conversations, contacts and reply tools to agents โ support workflows in your IDE, secured by Intercom OAuth.
- Provider
- Intercom โ
- Categories
- ๐ Project Management & Productivity
ไธญๆ็ฎไป
Intercom ๅฎๆน่ฟ็จ MCP ๆๅกๅจใAI ไปฃ็ๅฏๆ็ดขไผ่ฏใๆฅ่ฏข่็ณปไบบๅนถๅๅคๅฏน่ฏ็บฟ็จ๏ผOAuth ๆๆ๏ผใ
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"intercom": {
"url": "https://mcp.intercom.com/mcp"
}
}
}claude mcp add --transport http intercom https://mcp.intercom.com/mcp
Or add to .vscode/mcp.json:
{
"servers": {
"intercom": {
"type": "http",
"url": "https://mcp.intercom.com/mcp"
}
}
}- Open Settings โ Connectors (Integrations) โ Add Custom Connector.
- Paste the endpoint URL:
https://mcp.intercom.com/mcp - Complete the browser OAuth 2.1 login flow when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"intercom": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.intercom.com/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"intercom": {
"serverUrl": "https://mcp.intercom.com/mcp"
}
}
}๐งฐ Tools exposed by Intercom MCP (3)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| search_conversations | ๐ข Read | Search Intercom conversations by state, contact or text. | query*: stringstate: string |
| get_contact_details | ๐ข Read | Retrieve an Intercom contact's attributes. | contactId*: string |
| reply_to_conversation | ๐ Write | Post a reply into an Intercom conversation thread. Sends a real message to the customer. | conversationId*: stringbody*: string |
๐ OAuth 2.1 & Security
- Auth type
- OAuth 2.1
- Dynamic Client Registration
- โ Supported
- PKCE S256
- โ Supported
- Protected resource metadata
- https://mcp.intercom.com/.well-known/oauth-protected-resource (expected location)
๐งฉ Recommended Agent Skills
๐ Guide
Intercom MCP โ Remote MCP Server
Intercom's remote MCP lets agents pull conversation context and contact records into support and triage workflows โ and reply on your behalf when you approve it. Streamable HTTP transport with OAuth 2.1 authorization.
Endpoint & Transport
- Endpoint URL:
https://mcp.intercom.com/mcp - Transport: Streamable HTTP
Authentication
Intercom MCP uses OAuth 2.1 โ the first request returns a 401 Unauthorized challenge with a WWW-Authenticate header pointing at the authorization metadata. Compliant clients (Cursor, Claude, VS Code, ChatGPT) handle the whole flow โ PKCE and Dynamic Client Registration, so no manual client setup is needed โ and simply open a browser consent screen.
Available Tools (3)
| Tool | Safety | Description |
|---|---|---|
search_conversations |
read | Search Intercom conversations by state, contact or text. |
get_contact_details |
read | Retrieve an Intercom contact's attributes. |
reply_to_conversation |
write | Post a reply into an Intercom conversation thread. Sends a real message to the customer. |
Connect in 30 Seconds
Claude Code โ one command:
claude mcp add --transport http intercom https://mcp.intercom.com/mcp
Cursor โ add to ~/.cursor/mcp.json:
{ "mcpServers": { "intercom": { "url": "https://mcp.intercom.com/mcp" } } }
VS Code โ add to .vscode/mcp.json:
{ "servers": { "intercom": { "type": "http", "url": "https://mcp.intercom.com/mcp" } } }
Claude Desktop & stdio clients โ bridge with mcp-remote:
{ "mcpServers": { "intercom": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.intercom.com/mcp"] } } }
On first connect your client opens a browser OAuth consent screen โ approve it and tools become available immediately.
Troubleshooting
- 401 Unauthorized on connect โ that's expected; the server is OAuth-protected. Let your client complete the browser consent flow, or inspect the endpoint in our OAuth debugger to see the exact
WWW-Authenticatechallenge. - "Session expired" / stale
Mcp-Session-Idโ just re-sendinitialize; stateless clients can ignore session headers entirely. - reply_to_conversation sends a real message to the customer โ clients will typically ask for confirmation.
- Access is scoped to the authorizing teammate's permissions.
๐ How to Connect
- Copy the Intercom MCP endpoint URLThe remote endpoint is https://mcp.intercom.com/mcp.
- Add it to your MCP clientClaude Code:
claude mcp add --transport http intercom https://mcp.intercom.com/mcp. Cursor: add"intercom": { "url": "https://mcp.intercom.com/mcp" }undermcpServersin ~/.cursor/mcp.json. Other clients work similarly. - Complete the OAuth consentOn first connection your client opens a Intercom consent screen in the browser. Approve it to grant access; the token is stored by the client and refreshed automatically.
- Verify with the online inspectorPaste https://mcp.intercom.com/mcp into remotemcp.net/inspector, run initialize and tools/list, and confirm Intercom MCP's 3 tools respond.
โ FAQ
What is the Intercom MCP remote MCP endpoint?
The primary endpoint is https://mcp.intercom.com/mcp. It is an official first-party server operated by Intercom, speaking the Streamable HTTP transport.
How do I authenticate with Intercom MCP?
Intercom MCP uses OAuth 2.1. When your client first connects it receives a 401 challenge, discovers the authorization server via RFC 9728 metadata, and opens a browser consent screen. Dynamic Client Registration is supported, so compliant clients register themselves automatically.
I'm getting a 401 Unauthorized from Intercom MCP โ what's wrong?
A 401 means your client hasn't completed (or has lost) the OAuth authorization. Remove and re-add the server in your client to restart the consent flow, and check that your browser session can reach the provider's login page. If the 401 arrives without a WWW-Authenticate header, run it through our OAuth debugger to see what's missing.
Which MCP clients work with Intercom MCP?
Any client that supports remote MCP servers: Cursor, Claude Code (`claude mcp add --transport http intercom https://mcp.intercom.com/mcp`), VS Code Copilot, ChatGPT connectors, Windsurf, and Claude Desktop via the `mcp-remote` bridge.
What tools does Intercom MCP expose?
3 tools are cataloged in this directory โ including `search_conversations`, `get_contact_details`, `reply_to_conversation`. Use our online inspector to fetch the live tool list straight from the endpoint.
๐ Connect Guides
๐ Embed Status Badge in README
Related Servers
Notion's official hosted MCP server. Agents can search your workspace, read and create pages, and query databases over Streamable HTTP or SSE.
Linear's official remote MCP server. Agents can search, create and update issues and query your team's workflow over Streamable HTTP or SSE.
Atlassian's official remote MCP server for Jira and Confluence. Search and create issues and pages over the legacy SSE transport with OAuth 2.1.
Asana's official remote MCP server. Agents can search tasks, create work items and read project structure over the SSE transport with OAuth.