MCP Intercom Server

What is MCP Intercom Server?

MCP Intercom Server is a Model Context Protocol (MCP) server that provides read-only access to Intercom conversations and chats. It allows LLMs to query and analyze conversations using various filtering options. The server is secured with an Intercom API key.

How to use MCP Intercom Server?

Install dependencies with npm install, set your INTERCOM_API_KEY in the .env file, and build the server with npm run build. Start the server with npm start, or configure it as an MCP server in Claude for Desktop by adding the path to the built index.js and your API key to the claude_desktop_config.json file. The server exposes the search-conversations tool with filtering parameters.

Key features of MCP Intercom Server

• Query Intercom conversations with date range filters
• Filter by customer ID and conversation state
• Secure access using an Intercom API key
• Retrieve rich conversation data including contact info
• Access conversation statistics and priority information

Use cases of MCP Intercom Server

• Search for conversations created after a specific date
• List all open email conversations in Intercom
• Find unread conversations for a support review
• Analyze conversation update times within a period
• Retrieve conversations by state (open/closed)

FAQ from MCP Intercom Server

What dependencies are required to run MCP Intercom Server?

Node.js and npm are required. An Intercom API key must be provided in the INTERCOM_API_KEY environment variable.

How is authentication handled?

The server uses an Intercom API key stored securely in the INTERCOM_API_KEY environment variable. All API requests include proper authentication.

Can I modify or write to Intercom conversations through this server?

No. The server provides only read access to conversations; it does not support writing or modifying any data.

What transport does MCP Intercom Server use?

The server runs as a stdio-based MCP subprocess, configured in Claude for Desktop by specifying the node command and the path to the built server script.

What filtering options are available for the search-conversations tool?

Filters include creation date (createdAt), update date (updatedAt), source type (sourceType), conversation state (state), open status (open), and read status (read).