FastIntercom

Provides fast local access to Intercom conversations with intelligent syncing and compact storage for MCP clients.

python

GitHub Stars

python

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "evolsb-fast-intercom-mcp": {
      "command": "fast-intercom-mcp",
      "args": [
        "start"
      ],
      "env": {
        "INTERCOM_ACCESS_TOKEN": "YOUR_TOKEN_HERE",
        "FASTINTERCOM_LOG_LEVEL": "INFO",
        "FASTINTERCOM_MAX_SYNC_AGE_MINUTES": "5",
        "FASTINTERCOM_BACKGROUND_SYNC_INTERVAL": "10"
      }
    }
  }
}

You can run a fast, local MCP server that gives you instant access to Intercom conversations, with intelligent background syncing and compact storage. This server lets you query and manage conversations efficiently from your desktop MCP client and Claude Desktop integration, while keeping data refreshed in the background.

How to use

Start by launching the MCP server locally and connecting your client (such as Claude Desktop) to it. You’ll typically start the server with a simple command, then use the MCP client to search conversations, get details, and trigger syncs. The server serves data from a local cache for speed and uses background syncing to keep data fresh.

How to install

Prerequisites: you will need Python and a virtual environment or an equivalent Python setup on your system.

Install steps you should perform on a fresh system:

Create and activate a virtual environment

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install the MCP server package in editable mode

pip install -e .

Initialize the server with your Intercom credentials and verify status

fast-intercom-mcp init
fast-intercom-mcp status

Optional: synchronize your conversation history (last 7 days as an example)

fast-intercom-mcp sync --force --days 7

Configuration and usage details

Configure access and behavior through environment variables and a configuration file. The server reads the Intercom access token from an environment variable and allows you to tune logging and sync behavior via settings.

Claude Desktop integration example

To connect Claude Desktop, add an MCP server entry in your Claude Desktop configuration with the following settings.

{
  "mcpServers": {
    "fast-intercom-mcp": {
      "command": "fast-intercom-mcp",
      "args": ["start"],
      "env": {
        "INTERCOM_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

Available tools

search_conversations

Query conversations with text, timeframes, and filters to retrieve matching results.

get_conversation

Fetch full details for a specific Intercom conversation by ID.

get_server_status

Retrieve current server health, status, and statistics.

sync_conversations

Trigger a manual synchronization of conversations, with an option to force full sync.

Built by

VeilStrat

AI signals for GTM teams