Skip to main content
Glama
Sign In
intercom-mcp

intercom-mcp

by chenzhaoxuan0
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

intercom-mcp

Dedalus MCP server for Intercom support and customer communications. It exposes contact search, contact lookup, conversation listing, conversation lookup, customer-visible replies, and internal notes.

Tools

  • search_contacts - Search contacts by field/operator/value or list recent contacts when no value is provided.

  • get_contact - Fetch one contact by ID.

  • list_conversations - List conversations, optionally filtered by state.

  • get_conversation - Fetch one conversation by ID.

  • reply_to_conversation - Send a customer-visible admin reply.

  • create_note - Add an internal note to a conversation.

Related MCP server: Intercom MCP Server

Safety Notes

reply_to_conversation contacts real users. Confirm the conversation, admin identity, and body before calling it. create_note is separate and documented as internal-only so agents do not accidentally send private triage notes to customers.

Intercom conversation data may contain personal data and support history. Do not commit OAuth tokens, client secrets, conversation exports, or customer messages.

Authentication

This is a Dedalus Type 4 OAuth server. The server declares one DAuth connection named intercom-mcp with secret key INTERCOM_ACCESS_TOKEN. Dedalus handles OAuth authorization, token exchange, and runtime credential injection.

Deployment variables:

OAUTH_ENABLED=true
OAUTH_AUTHORIZE_URL=https://app.intercom.com/oauth
OAUTH_TOKEN_URL=https://api.intercom.io/auth/eagle/token
OAUTH_CLIENT_ID=...
OAUTH_CLIENT_SECRET=...
OAUTH_SCOPES_AVAILABLE=read_admins,read_contacts,write_contacts,read_conversations,write_conversations
OAUTH_BASE_URL=https://api.intercom.io
INTERCOM_VERSION=2.14
DEDALUS_AS_URL=https://as.dedaluslabs.ai

Adjust scopes to the minimum needed for your Intercom app and workspace approval flow.

Run Locally

uv run python src/main.py

In another terminal:

MCP_SERVER_URL=http://127.0.0.1:8080/mcp uv run python src/_client.py

src/_client.py explicitly calls every tool. Use INTERCOM_TEST_CONTACT_ID, INTERCOM_TEST_CONVERSATION_ID, and INTERCOM_TEST_ADMIN_ID to point the smoke test at safe records.

Deploy

Publish as dedalus-labs/intercom-mcp, configure OAuth in Dedalus, deploy, then run:

DEDALUS_MCP_SERVER_ONLY=1 DEDALUS_MCP_SERVER=dedalus-labs/intercom-mcp uv run python src/_client.py

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • MCP Intercom Server

      fabian1710
      A
      license
      B
      quality
      D
      maintenance
      Provides access to Intercom conversations and chats through the Model Context Protocol, allowing LLMs to query and analyze Intercom conversations with various filtering options.
      2
      8
      MIT

    • intercom-mcp-server

      OtakuXavier
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Intercom's customer communications platform via the Intercom REST API, providing 102 tools for managing admins, articles, companies, contacts, conversations, and more.
      2
      MIT

    • mcp-intercom

      pipeworx-io
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to search and manage Intercom contacts, conversations, and companies through OAuth authentication.
      136 npm
      MIT