MCP Server For Intercom

🚀 Intercom MCP Server

This is a server compliant with the MCP protocol, allowing AI assistants to access and analyze Intercom's customer support data.

🚀 Quick Start

This server compliant with the MCP protocol enables AI assistants to access and analyze Intercom's customer support data. The project documentation is hosted on GitHub.

✨ Features

• Search for conversations and tickets with advanced filtering capabilities.
• Classify and filter tickets.
• Search for tickets associated with customers.
• Comply with the MCP protocol and be compatible with Claude Desktop and other AI tools.

📦 Installation

Prerequisites

1. Node.js (version 14 or higher is recommended).
2. Docker (optional, for containerized deployment).

Quick Installation (Using NPM)

# Clone the repository and enter the directory
git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git
cd mcp-server-for-intercom

# Install dependencies
npm install

# Start the service
npm start

Quick Installation (Using Docker)

# Pull the image and run
docker pull raoulbianet/mcp-server-intercom:latest
docker run -it --rm -p 3000:3000 raoulbianet/mcp-server-intercom:latest

Verification Steps

# Check if the service is running properly
curl http://localhost:3000/health

💻 Usage Examples

This server provides the following MCP tool interfaces:

1. Conversation Search: Supports advanced filtering features such as time range, tags, and content keywords.
2. Ticket Classification: Classifies customer issues according to preset rules.
3. Customer - Associated Tickets: Finds ticket records of specific customers through unique identifiers (such as email or user ID).

Configuration Example

Add the following content to claude_desktop_config.json:

{
  "mcpServers": {
    "intercom-mcp": {
      "command": "intercom-mcp",
      "args": [],
      "env": {
        "INTERCOM_ACCESS_TOKEN": "your_intercom_api_token"
      }
    }
  }
}

🔧 Technical Details

Implementation Notes

• Uses the Intercom REST API and Webhooks for data interaction.
• Data processing complies with GDPR and privacy protection requirements.
• Provides detailed logging and monitoring functions.

Refer to src/services/INTERCOM_API_NOTES.md for detailed technical documentation.

💻 Development Guide

# Clone the repository and install dependencies
git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git
cd mcp-server-for-intercom
npm install

# Build and run the development environment
npm run build
npm run dev

# Run tests
npm test

⚠️ Important Note

1. This project is an independent integration and has no association with Intercom Inc.
2. "Intercom" is a registered trademark of Intercom Inc.

📄 License

This project is licensed under the Apache License 2.0. See the LICENSE file for specific terms.