Cover image
Try Now
2025-03-14

3 years

Works with Finder

1

Github Watches

2

Github Forks

3

Github Stars

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 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

  1. Install the package globally:

    npm install -g mcp-server-for-intercom
    
  2. 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"
    
  3. Run the server:

    intercom-mcp
    

Development Setup

  1. Clone the repository:

    git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git
    cd mcp-server-for-intercom
    
  2. Install dependencies:

    npm install
    
  3. Build the project:

    npm run build
    
  4. Set your Intercom API token as an environment variable (see above)

  5. Run the server in development mode:

    npm run dev
    

Testing

Run tests with:

npm test

Run tests in watch mode:

npm run test:watch

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:

npm install -g @modelcontextprotocol/inspector

Running the Inspector

To inspect your MCP server, use the following command:

npx @modelcontextprotocol/inspector node build/index.js

This will:

  1. Start your MCP server
  2. Launch a web interface (typically at http://localhost:3000)
  3. 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:

{
  "startDate": "15/01/2025",
  "endDate": "21/01/2025",
  "keyword": "billing"
}

Response Format:

{
  "result": [
    {
      "ticket_id": "12345",
      "subject": "Billing Issue",
      "status": "resolved",
      "created_at": "2024-03-06T10:15:00Z",
      "conversation": [
        {
          "from": "customer",
          "text": "Hey, I was double charged!",
          "timestamp": "2024-03-06T10:15:00Z"
        },
        {
          "from": "support_agent",
          "text": "We've refunded the duplicate charge.",
          "timestamp": "2024-03-06T10:45:00Z"
        }
      ]
    }
  ]
}

Usage with Claude Desktop

To integrate the MCP Server for Intercom with Claude Desktop:

  1. Get API Tokens: Ensure you have an Intercom API token. You can obtain this from your Intercom account settings.

  2. 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:

  1. Clone the Repository:

    git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git
    cd mcp-server-for-intercom
    
  2. Install Dependencies:

    npm install
    
  3. Build the Project:

    npm run build
    
  4. 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.

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Contact and Support

For questions, feature requests, or bug reports, please open an issue in the Issues section of this repository. You can also reach out to me directly via my GitHub profile.

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.

相关推荐

  • NiKole Maxwell
  • I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Khalid kalib
  • Write professional emails

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • ANGEL LEON
  • A world class elite tech co-founder entrepreneur, expert in software development, entrepreneurship, marketing, coaching style leadership and aligned with ambition for excellence, global market penetration and worldy perspectives.

  • INFOLAB OPERATIONS 2
  • A medical specialist offering assistance grounded in clinical guidelines. Disclaimer: This is intended for research and is NOT safe for clinical use!

  • Yasir Eryilmaz
  • AI scriptwriting assistant for short, engaging video content.

  • Daren White
  • A supportive coach for mastering all Spanish tenses.

  • apappascs
  • 发现市场上最全面,最新的MCP服务器集合。该存储库充当集中式枢纽,提供了广泛的开源和专有MCP服务器目录,并提供功能,文档链接和贡献者。

  • ShrimpingIt
  • MCP系列GPIO Expander的基于Micropython I2C的操作,源自ADAFRUIT_MCP230XX

  • OffchainLabs
  • 进行以太坊的实施

  • huahuayu
  • 统一的API网关,用于将多个Etherscan样区块链Explorer API与对AI助手的模型上下文协议(MCP)支持。

  • deemkeen
  • 用电源组合控制您的MBOT2:MQTT+MCP+LLM

  • zhaoyunxing92
  • MCP(消息连接器协议)服务

  • pontusab
  • 光标与风浪冲浪社区,查找规则和MCP

    Reviews

    2 (1)
    Avatar
    user_Dovqio95
    2025-04-16

    As a dedicated user of the mcp-server-for-intercom, I can confidently say this is an outstanding solution for managing intercom systems. The integration is seamless and Raoulbia-ai has done an excellent job with the implementation. It's a must-have for anyone serious about efficient intercom management. For more details, you can check it out on GitHub here: https://github.com/raoulbia-ai/mcp-server-for-intercom.