MCP Intercom Server

Features

• Query Intercom conversations with filtering options: - Date range (start and end dates) - Customer ID - Conversation state

• Secure access using your Intercom API key

• Rich conversation data including: - Basic conversation details - Contact information - Statistics (responses, reopens) - State and priority information

Installation

1. Clone the repository:

1. Install dependencies:

1. Set up your environment:

1. Add your Intercom API key to `.env`:

1. Build the server:

Usage

Running the Server

Using with Claude for Desktop

1. Add the server to your Claude for Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS or `%AppData%\Claude\claude_desktop_config.json` on Windows):

1. Restart Claude for Desktop

Available Tools

search-conversations

• `createdAt` (optional): Object with `operator` (e.g., ">", "<", "=") and `value` (UNIX timestamp) for filtering by creation date.

• `updatedAt` (optional): Object with `operator` (e.g., ">", "<", "=") and `value` (UNIX timestamp) for filtering by update date.

• `sourceType` (optional): Source type of the conversation (e.g., "email", "chat").

• `state` (optional): Conversation state to filter by (e.g., "open", "closed").

• `open` (optional): Boolean to filter by open status.

• `read` (optional): Boolean to filter by read status.

• "Search for all conversations created after January 1, 2024"

• "Find conversations updated before last week"

• "List all open email conversations"

• "Get all unread conversations"

Security

• The server requires an Intercom API key to function

• API key should be stored securely in environment variables

• The server only provides read access to conversations

• All API requests are made with proper authentication

Development

1. Start development mode with auto-recompilation:

1. Run linting:

Contributing

1. Fork the repository

2. Create a new branch for your feature

3. Make your changes

4. Submit a pull request

License