Gong MCP

⬇️ Install in Claude Desktop (one click, no terminal)

If you use the Claude Desktop app, this is the easy path. No Node, no JSON, no command line.

1. Download gong-mcp.mcpb (one file).

2. Double-click it (or in Claude Desktop go to Settings → Extensions → Install extension… and pick the file).

3. When prompted, paste your Gong base URL, Access Key, and Access Secret (see how to get them), then click Install.

That is it. Ask Claude "list my Gong workspaces" to confirm it is connected.

Prefer Claude Code / Cursor / a terminal? Jump to Install in Claude Code.

Related MCP server: OpenAPI MCP Server

Gong MCP vs the official Gong MCP

Gong ships an official hosted MCP server at mcp.gong.io. It is a different tool for a different job: three AI tools that return generated answers and briefs. This repo exposes the raw Gong REST API instead, so you get the underlying data and can build your own analysis on top.

Rule of thumb: use the official server for quick AI briefs with zero infrastructure; use this one when you need raw transcripts, call and activity data, or want to build your own analysis over the full API.

Tools

Getting your Gong credentials

1. In Gong, go to Company Settings → API.

2. Click Get API Key (Technical Administrator role required).

3. Copy the Access Key and Access Key Secret.

4. Note your workspace host (region-specific), which looks like https://us-XXXXX.api.gong.io. It is shown alongside your API key in Gong. If left blank, the server falls back to https://api.gong.io.

Credentials are read from environment variables (GONG_ACCESS_KEY, GONG_ACCESS_SECRET, GONG_BASE_URL) or the Claude Desktop install dialog. Nothing is hardcoded and nothing is committed to this repo.

Install in Claude Code

For the CLI / terminal agent (and Cursor, or any MCP client).

git clone https://github.com/scandolo/gong-mcp.git
cd gong-mcp
npm install

# register the server with Claude Code (user scope)
claude mcp add gong node "$(pwd)/server/index.js" \
  --scope user \
  --env GONG_BASE_URL=https://us-XXXXX.api.gong.io \
  --env GONG_ACCESS_KEY=your-access-key \
  --env GONG_ACCESS_SECRET=your-access-secret

Or add it directly to ~/.claude.json under mcpServers:

{
  "mcpServers": {
    "gong": {
      "command": "node",
      "args": ["/absolute/path/to/gong-mcp/server/index.js"],
      "env": {
        "GONG_BASE_URL": "https://us-XXXXX.api.gong.io",
        "GONG_ACCESS_KEY": "your-access-key",
        "GONG_ACCESS_SECRET": "your-access-secret"
      }
    }
  }
}

Restart Claude Code and ask it to run list_workspaces to confirm auth.

Copy-paste prompt (Claude Code): paste this into a Claude Code session, filling in your three values.

Set up the Gong MCP server (https://github.com/scandolo/gong-mcp) in this Claude Code
environment for me. Do the following:

1. Clone https://github.com/scandolo/gong-mcp into ~/code/gong-mcp (or tell me if it
   already exists), then run `npm install` in it.
2. Register it with Claude Code at user scope using `claude mcp add`, with these env vars:
     GONG_BASE_URL=<PASTE YOUR HOST, e.g. https://us-XXXXX.api.gong.io>
     GONG_ACCESS_KEY=<PASTE YOUR GONG ACCESS KEY>
     GONG_ACCESS_SECRET=<PASTE YOUR GONG ACCESS SECRET>
3. Verify the server is registered with `claude mcp list`.
4. Tell me to restart Claude Code, then confirm it works by calling the `list_workspaces` tool.

Never print my access key or secret back to me or write them into any tracked/committed file.

Build the Claude Desktop bundle yourself

The prebuilt .mcpb is attached to every release. To build it from source:

npm install
npx @anthropic-ai/mcpb pack   # produces gong-mcp.mcpb

Configuration

Authentication uses HTTP Basic auth (AccessKey:Secret, base64-encoded) exactly as the Gong REST API expects. The client retries on transient errors and rate limits with exponential backoff.

Requirements

• Node.js >= 18 (bundled with Claude Desktop; install separately for Claude Code)

• A Gong seat with API access (Technical Administrator to mint keys)

Contributing

Issues and PRs welcome, especially additional Gong endpoints as the API grows. See the issue templates when opening a report.

License

MIT

Keywords: Gong MCP, Gong MCP server, Gong API MCP, Gong Model Context Protocol, Gong API gateway, Gong Claude integration, Gong Claude Desktop extension, Gong conversation intelligence MCP, Gong REST API wrapper, RevOps MCP, sales intelligence MCP.