Skip to content
Status

Intercom

Connect a US- or EU-hosted Intercom workspace through Intercom's hosted MCP server using a manually registered OAuth app.

You need an Intercom workspace hosted in the US or EU. You also need access to the Intercom Developer Hub and permission to create and configure an OAuth app for that workspace. Intercom does not name a required plan or administrator role.

Sign in to the intended workspace. The app setup starts in the Intercom Developer Hub.

Identify the workspace region

  1. Open the intended Intercom workspace.
  2. Inspect its hostname in the browser address bar.
  3. Record the matching remote URL:
    • For app.intercom.com, record https://mcp.intercom.com/mcp.
    • For app.eu.intercom.com, record https://mcp.eu.intercom.com/mcp.
  4. If the hostname is app.au.intercom.com, stop. Intercom does not support its MCP server for Australian-hosted workspaces.

If Intercom cannot find the workspace:

  1. Return to Intercom’s sign-in page.
  2. Under Your account region, select the region matching the workspace URL: United States, Europe, or Australia.
  3. Sign in again.

Create the OAuth app

  1. Open the Intercom Developer Hub. This opens Your Apps.
  2. Select New App.
  3. In the modal, enter an organization-approved app name.
  4. Select the workspace this connection will access.
  5. Select Create app.

Intercom creates the app, installs it in the selected workspace, and opens its configuration.

Configure OAuth

  1. In the created app, open Authentication.

  2. Select Use OAuth. This reveals Redirect URLs and Permissions.

  3. Under Redirect URLs, select Add redirect URL.

  4. Enter this value:

    https://app.getgram.ai/mcp/remote_login_callback

  5. Under Permissions, select:

    • Read and list users and companies
    • Read conversations
    • Read one admin
    • Read and List articles

  6. If the organization requires article creation or updates through the MCP server, select Read and Write Articles instead of Read and List articles.

  7. Complete the page’s save or confirmation control.

Copy the client credentials

  1. Open the app’s Basic Information page.
  2. Copy the Client ID into a password manager.
  3. Copy the Client secret into the password manager.

Add the server in Speakeasy

  1. In the Speakeasy AI Control Plane sidebar, under Connect, select Sources.
  2. Click Add Source.
  3. Choose Custom remote server.
  4. On Add a custom remote MCP server, paste the remote URL from Identify the workspace region into Remote MCP server URL.
  5. Click Add server.

This creates the hosted MCP server and opens its Overview page.

Connect your credentials

  1. From the server’s Overview, open Settings.

  2. Under Authentication, click Configure Manually.

  3. In Attach Remote Identity Provider, set Client Type to Manual.

  4. Enter https://mcp.intercom.com as Issuer URL.

  5. Under Endpoints, set the authorization endpoint to https://app.intercom.com/oauth.

  6. Set the token endpoint to this URL:

    https://api.intercom.io/auth/eagle/token

  7. Paste the Client ID from Copy the client credentials.

  8. Paste the Client Secret (optional) from Copy the client credentials.

  9. Leave Scope (override) empty.

  10. Leave Audience (optional) empty.

  11. Confirm that Redirect URI is https://app.getgram.ai/mcp/remote_login_callback, matching the value registered in Configure OAuth.

  12. Click Attach Identity Provider.

When a client initiates Intercom access, complete the on-screen browser prompts with the intended workspace account.

This guide covers setup only. For anything beyond it — billing, tool behavior, limits — see Intercom’s MCP documentation.