MCP Server for Intercom
An MCP-compliant server for retrieving customer support tickets from Intercom. This tool enables AI assistants like Claude Desktop and Cline to access and analyze your Intercom support tickets.
Features
- Retrieve all support tickets (open and closed) with full conversation history
- Filter tickets by creation date
- Pagination support for handling large volumes of tickets
- Seamless integration with MCP-compliant AI assistants
Disclaimer
This project is an independent integration and is not affiliated with, officially connected to, or endorsed by Intercom Inc. "Intercom" is a registered trademark of Intercom Inc.
Compliance with Intercom Developer Terms
This project is designed to comply with Intercom's developer terms of service by:
- **Securing API Tokens**: Ensuring Intercom API tokens are kept confidential and secure
- **Responsible Data Handling**: Accessing and storing user data responsibly
- **Limited Scope**: Only implementing necessary functionality to retrieve ticket data
- **Transparency**: Clearly documenting data usage and application features
Users of this integration should review Intercom's [Developer Terms](https://developers.intercom.com/docs/publish-to-the-app-store/intercom-developer-terms) to ensure their implementation complies with all requirements.
Installation
Prerequisites
- Node.js 18.0.0 or higher
- An Intercom account with API access
Quick Start
- Install the package globally: ``` npm install -g mcp-server-for-intercom ```
- Set your Intercom API token: ``` # For Linux/Mac export INTERCOM_ACCESS_TOKEN="your_token_here" # For Windows Command Prompt set INTERCOM_ACCESS_TOKEN=your_token_here # For PowerShell $env:INTERCOM_ACCESS_TOKEN = "your_token_here" ```
- Run the server: ``` intercom-mcp ```
Development Setup
- Clone the repository: ``` git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git cd mcp-server-for-intercom ```
- Install dependencies: ``` npm install ```
- Build the project: ``` npm run build ```
- Set your Intercom API token as an environment variable (see above)
- Run the server in development mode: ``` npm run dev ```
Testing
Run tests with:
Run tests in watch mode:
Using the MCP Inspector
The MCP Inspector is a useful tool for debugging and testing your MCP server implementation. It provides a web interface to interact with your server and visualize the requests and responses.
Installation
The MCP Inspector is available as an npm package:
Running the Inspector
To inspect your MCP server, use the following command:
This will:
- Start your MCP server
- Launch a web interface (typically at http://localhost:3000)
- Allow you to send requests and view responses
Important Notes
- When using the inspector with this server, you must prefix the command with `node` as shown above
- Make sure your environment variables (like `INTERCOM_ACCESS_TOKEN`) are set properly
- The web interface lets you: - View available tools - Send test requests - Debug response formatting - Monitor request/response flow
The inspector is particularly helpful when:
- Implementing new tools
- Debugging parameter handling issues
- Testing date format validation
- Verifying error messages
API Reference
`list_tickets`
Retrieves all support tickets with their conversation history within a specific date range.
**Request Parameters:**
- `startDate` (DD/MM/YYYY format) The start date for ticket retrieval (required)
- `endDate` (DD/MM/YYYY format) The end date for ticket retrieval (required)
- `keyword` (string) Optional filter to only include tickets containing this text
- `exclude` (string) Optional filter to exclude tickets containing this text
**Important Notes:**
- Date range must not exceed 7 days
- Both startDate and endDate are required
- Dates must use the DD/MM/YYYY format (e.g., "15/01/2025")
**Example Request:**
**Response Format:**
Usage with Claude Desktop
To integrate the MCP Server for Intercom with Claude Desktop:
- **Get API Tokens**: Ensure you have an Intercom API token. You can obtain this from your Intercom account settings.
- **Configure Claude Desktop**: Add the following configuration to your `claude_desktop_config.json` file: ``` { "mcpServers": { "intercom-mcp": { "command": "intercom-mcp", "args": [], "env": { "INTERCOM_ACCESS_TOKEN": "your_intercom_api_token" } } } } ``` Replace `"your_intercom_api_token"` with your actual Intercom API token.
Using a Local Development Version
If you've cloned the repository and want to run a local version of the MCP Server for Intercom:
- **Clone the Repository**: ``` git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git cd mcp-server-for-intercom ```
- **Install Dependencies**: ``` npm install ```
- **Build the Project**: ``` npm run build ```
- **Configure Claude Desktop**: Add the following configuration to your `claude_desktop_config.json` file: ``` { "mcpServers": { "intercom-mcp-local": { "command": "npm", "args": ["run", "dev"], "env": { "INTERCOM_ACCESS_TOKEN": "your_intercom_api_token", "NODE_ENV": "development" }, "cwd": "/path/to/your/mcp-server-for-intercom" } } } ``` Replace `"your_intercom_api_token"` with your actual Intercom API token and `"/path/to/your/mcp-server-for-intercom"` with the path to your cloned repository.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the project
- Create your feature branch (`git checkout -b feature/amazing-feature`)
- Commit your changes (`git commit -m 'Add some amazing feature'`)
- Push to the branch (`git push origin feature/amazing-feature`)
- Open a Pull Request
Contact and Support
For questions, feature requests, or bug reports, please open an issue in the [Issues](https://github.com/raoulbia-ai/mcp-server-for-intercom/issues) section of this repository.
You can also reach out to me directly via my [GitHub profile](https://github.com/raoulbia-ai).
License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details. The Apache License 2.0 provides additional protections including patent grants, trademark protection, and modification notices, making it ideal for open-source projects that require more comprehensive legal safeguards.