mcp-server-for-intercom

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.

4
1

MCP Server for Intercom

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.

Features

  • Retrieves all support tickets with conversation history.
  • Filters tickets by creation date.
  • Supports pagination for large datasets.
  • Integrates with MCP-compliant AI assistants.

Disclaimer

This project is an independent integration and is not affiliated with Intercom Inc.

Compliance with Intercom Developer Terms

The project secures API tokens, handles data responsibly, limits scope to necessary functionality, and documents data usage transparently, adhering to Intercom's developer terms.

Installation

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.

Development Setup

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.

Testing

The testing guide covers running tests and running tests in watch mode.

Using the MCP Inspector

The MCP Inspector is a useful tool for debugging and testing your MCP server implementation.

API Reference

The API reference covers the list_tickets endpoint, including request parameters, important notes, example request, and response format.

Usage with Claude Desktop

The usage guide covers integrating the MCP Server for Intercom with Claude Desktop.

Using a Local Development Version

The usage guide covers using a local development version of the MCP Server for Intercom.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Contact and Support

For questions, feature requests, or bug reports, please open an issue in the Issues section of this repository.

License

This project is licensed under the Apache License 2.0.

Repository

RA
raoulbia-ai

raoulbia-ai/mcp-server-for-intercom

Created

March 9, 2025

Updated

March 23, 2025

Language

TypeScript

Category

Communication