MCP 服务器

Gong MCP

a full-surface Model Context Protocol gateway to the Gong REST API (calls, transcripts, users, activity, scorecards, coaching, CRM). Full API coverage, zero prerequisites, bring your own credentials.

README

The full-surface <a href="https://modelcontextprotocol.io">Model Context Protocol</a> server for the <a href="https://www.gong.io">Gong</a> API. 20 tools across calls, transcripts, users, activity, scorecards, coaching and CRM. Install into Claude Desktop in one click.

⬇️ 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.

Download gong-mcp.mcpb (one file).
Double-click it (or in Claude Desktop go to Settings → Extensions → Install extension… and pick the file).
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.

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.

	Official Gong MCP (`mcp.gong.io`)	This repo (`gong-mcp`)
Tools	3 (`ask_account`, `ask_deal`, `generate_brief`)	20 (raw REST API surface)
Returns	AI-generated answers and briefs	raw data: transcripts, calls, users, activity, scorecards, coaching, CRM
Raw transcripts / call lists	not returned	yes
Grain	account and deal	call, user, workspace, CRM
Hosting	Gong-hosted remote connector	self-hosted, runs locally
Auth and setup	admin creates an MCP integration, MCP scope, Client ID/Secret	your own Gong API key and secret
Cost	consumes Gong credits	free (your normal API quota)
Claude plan	Pro/Max/Team/Enterprise (custom remote connectors)	any (local stdio server)

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

Tool	What it does
`list_workspaces`	List Gong workspaces / confirm auth.
`list_calls`	List calls in a date range (light metadata).
`get_call`	Get one call's metadata by id.
`list_calls_extensive`	Rich call data: content, parties, stats, CRM context.
`get_transcripts`	Word-level call transcripts.
`list_library_folders`	List library folders for a workspace.
`get_library_folder_content`	List calls in a library folder.
`list_users`	List all Gong users.
`get_user`	Get one user by Gong id.
`get_users_extensive`	Batch user lookup by id or email.
`get_activity_aggregate`	Per-user activity totals.
`get_activity_by_period`	Per-user activity by period.
`get_activity_day_by_day`	Per-user, per-day activity.
`get_interaction_stats`	Rep interaction quality stats.
`list_scorecards`	List scorecard templates.
`get_answered_scorecards`	Actual answered scorecards.
`get_coaching_metrics`	Manager coaching metrics.
`get_manual_crm_associations`	Manual call-to-CRM associations.
`list_crm_integrations`	List CRM integrations.
`get_crm_entities`	Read custom-integration CRM objects.

Getting your Gong credentials

In Gong, go to Company Settings → API.
Click Get API Key (Technical Administrator role required).
Copy the Access Key and Access Key Secret.
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

Env var	Required	Default	Notes
`GONG_ACCESS_KEY`	yes	—	Gong API Access Key.
`GONG_ACCESS_SECRET`	yes	—	Gong API Access Key Secret.
`GONG_BASE_URL`	no	`https://api.gong.io`	Your workspace-specific host, e.g. `https://us-XXXXX.api.gong.io`.

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.