gong-mpc

An MCP server for querying Gong.io call data.

Scope: This MCP is intentionally focused on retrieving call data — listing calls, reading transcripts, browsing library folders, and pulling call details. It does not aim to be an exhaustive wrapper of the full Gong API. If you need capabilities beyond call retrieval (e.g. CRM sync, scorecards, users, forecasting), use the Gong REST API directly.

Prerequisites

• Install nodejs

Setup

Credentials

1. Go to the Gong Admin Centre.
2. Click on API in the Ecosystem section.
3. Click the Get API Key button.
4. Copy the API key and secret and store them somewhere safe on your machine.

Gong Workspace ID

Find it in Gong by looking for workspace-id= in the URL.

Environment Variables

| Variable | Required | Description | |---|---|---| | GONG_ACCESS_KEY | Yes | Gong API access key | | GONG_ACCESS_KEY_SECRET | Yes | Gong API access key secret | | GONG_WORKSPACE_ID | No | Gong Workspace ID | | GONG_BASE_URL | No | Override the Gong API base URL (default: https://us-11443.api.gong.io) |

Claude Code

Run this command in your terminal:

claude mcp add --scope user gong \
  --env GONG_ACCESS_KEY=your-access-key \
  --env GONG_ACCESS_KEY_SECRET=your-access-key-secret \
  --env GONG_WORKSPACE_ID=your-workspace-id \
  -- npx -y gong-mpc

Or manually add it to ~/.claude/settings.json:

{
  "mcpServers": {
    "gong": {
      "command": "npx",
      "args": ["-y", "gong-mpc"],
      "env": {
        "GONG_ACCESS_KEY": "your-access-key",
        "GONG_ACCESS_KEY_SECRET": "your-access-key-secret",
        "GONG_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

Claude Desktop

Edit the Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following under mcpServers:

{
  "mcpServers": {
    "gong": {
      "command": "npx",
      "args": ["-y", "gong-mpc"],
      "env": {
        "GONG_ACCESS_KEY": "your-access-key",
        "GONG_ACCESS_KEY_SECRET": "your-access-key-secret",
        "GONG_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

Restart Claude Desktop after saving the config for the changes to take effect.

Alternatively, use the setup-credentials tool at runtime to set credentials without editing config files directly.

Rate Limiting

Gong enforces two rate limits by default:

• 3 API calls per second
• 10,000 API calls per day

This MCP handles both limits automatically in the client:

• Per-second: A sliding window tracks recent call timestamps. If 3 calls have been made within the last second, subsequent calls wait transparently until the window clears. No errors are thrown — requests are queued and proceed as soon as capacity is available.
• Per-day: A counter tracks total calls for the current UTC day. If the 10,000 call limit is reached, an error is thrown immediately with the approximate time until the counter resets.

If Gong returns a 429 Too Many Requests despite the above (e.g. quota used by another process or integration), the error message will include the Retry-After value from Gong's response indicating how many seconds to wait.

Rate limit state is held in memory and resets if the MCP server process restarts.

Available Tools

setup-credentials

Store your Gong API credentials at runtime. Credentials are persisted locally so they survive server restarts.

Parameters:

• accessKey — Gong API access key
• accessKeySecret — Gong API access key secret
• workspaceId (optional) — Gong workspace ID. Find it by looking for workspace-id= in the Gong URL.

list-calls

List Gong calls within a date range. Returns call metadata including title, duration, scheduled/started times, direction, and participant info.

Parameters:

• fromDateTime (optional) — Start of date range in ISO 8601 format (e.g. 2024-01-01T00:00:00Z)
• toDateTime (optional) — End of date range in ISO 8601 format (e.g. 2024-01-31T23:59:59Z)
• cursor (optional) — Pagination cursor from a previous response to fetch the next page
• workspaceId (optional) — Filter calls by a specific Gong workspace ID

get-call

Retrieve full metadata for a single call by its ID.

Parameters:

• callId — Gong's unique numeric identifier for the call (up to 20 digits)

get-calls-extensive

Retrieve extended data for one or more calls, including interaction stats, trackers, and other enriched fields not available in list-calls.

Parameters:

• callIds — Array of Gong call IDs to retrieve extensive data for

get-call-transcripts

Retrieve the full transcript for one or more calls. Returns speaker-attributed sentences with timestamps.

Parameters:

• callIds — Array of Gong call IDs to retrieve transcripts for

list-folders

List all public Gong library folders. Private and archived folders are not returned by the Gong API.

Parameters:

• workspaceId (optional) — Filter folders by a specific Gong workspace ID

list-folder-calls

List all calls inside a specific library folder, including any notes attached to each call and snippet timestamps where applicable.

Parameters:

• folderId — Gong's unique numeric identifier for the folder (up to 20 digits)

Development

npm install
npm run build

Test with MCP inspector (requires env vars to be set):

npx @modelcontextprotocol/inspector node ./build/index.js