KocoroIntercom Integration Guide
With Kocoro's pre-installed Intercom MCP Server, let AI read your Intercom conversations, customers, tickets and team data directly — just flip one switch and complete a single OAuth authorization.
Before you begin
- You have the Kocoro Mac App installed (the Intercom MCP Server ships pre-installed — no need to Add Server manually).
- You have access to an Intercom workspace with permission to authorize third-party OAuth apps.
- Your network can reach Intercom.
- 1
Open MCP Servers
Launch the Kocoro Mac App, and in the left sidebar under Capabilities click MCP Servers. This is where Kocoro manages every external capability, Intercom included.
Fig. 1 — Kocoro main window, MCP Servers entry on the left. - 2
Find the pre-installed Intercom, flip the switch on
Kocoro already ships the Intercom MCP Server (https://mcp.intercom.com/mcp) in the list — you do not need to Add Server. Click the toggle on the right side of the intercom row; Kocoro will spawn your default browser and navigate to Intercom's OAuth consent page.
If you don't see intercom in the list, upgrade Kocoro to the latest version.Fig. 2 — MCP Servers list, click the toggle next to intercom. - 3
Review and authorize on Intercom
On the Intercom consent screen you'll see the scopes requested by intercom-api-mcp-server: read-only access to People, Companies, Conversations, Teams and teammates, Tags, AI content and more. Review them and click the green Authorize access button.
All requested scopes are read-only. Kocoro never writes anything back into your Intercom workspace.Fig. 3 — Intercom OAuth screen, click Authorize access. - 4
Authorization complete
Your browser will redirect automatically and display an authorization success page (you'll see Authorization successful!). Just close the tab — you're done.
Fig. 4 — OAuth callback success page. - 5
Back in Kocoro: verify the connection
Switch back to Kocoro's MCP Servers page. A green dot appears next to intercom and the toggle is on — the Intercom MCP connection is now live and Kocoro can call Intercom tools.
Fig. 5 — Connection active, green dot next to intercom.
Done — start using Intercom
Head back to Messages and just ask in plain English. Kocoro will pick the right Intercom tool and return structured results.
Prompts to try
- Which urgent Intercom conversations should I handle first today?
- Summarize new Intercom conversations from the past 7 days, grouped by customer company.
- What issues has Customer X raised this week? Summarize their key asks and what's still open.
- Turn every unread Intercom conversation today into a to-do list.
Troubleshooting
I don't see Intercom in the MCP Servers list.
Upgrade Kocoro to the latest version — the Intercom MCP Server is delivered as part of Kocoro and older versions may not include it yet.
The browser didn't open after I flipped the switch.
Make sure your system has a default browser set, then toggle the switch off and on again.
The green dot never appears after authorizing.
Toggle the switch off and back on in the MCP Servers list. If it still won't connect, open Kocoro's Settings and check the logs.
How do I revoke Kocoro's access to Intercom?
Revoke intercom-api-mcp-server from Authorized apps in your Intercom settings, or simply turn the toggle off in Kocoro's MCP Servers list.