This repository provides an MCP-compliant server that retrieves Intercom customer support tickets, enabling AI assistants to access and analyze them. It facilitates integration with tools like Claude Desktop and Cline.
This project provides an MCP-compliant server that retrieves customer support tickets from Intercom, enabling AI assistants like Claude Desktop and Cline to analyze them. It fetches all tickets (open and closed) with full conversation history, filters by creation date, and supports pagination.
This project is an independent integration and is not affiliated with Intercom Inc.
The project secures API tokens, handles data responsibly, limits scope to necessary functionality, and documents data usage transparently, adhering to Intercom's developer terms.
The installation guide covers prerequisites (Node.js 18.0.0+, Intercom API access), quick start instructions using npm install -g mcp-server-for-intercom
, setting the INTERCOM_ACCESS_TOKEN
environment variable, and running the server with intercom-mcp
.
The development setup guide covers cloning the repository, installing dependencies, building the project, setting the Intercom API token, and running the server in development mode.
The testing guide covers running tests and running tests in watch mode.
The MCP Inspector is a useful tool for debugging and testing your MCP server implementation.
The API reference covers the list_tickets
endpoint, including request parameters, important notes, example request, and response format.
The usage guide covers integrating the MCP Server for Intercom with Claude Desktop.
The usage guide covers using a local development version of the MCP Server for Intercom.
Contributions are welcome! Please feel free to submit a Pull Request.
For questions, feature requests, or bug reports, please open an issue in the Issues section of this repository.
This project is licensed under the Apache License 2.0.
raoulbia-ai/mcp-server-for-intercom
March 9, 2025
March 23, 2025
TypeScript