Gong MCP

<p align="center"> <img src="assets/social-preview.png" alt="Gong MCP — the full-surface Gong API gateway for Claude" width="820"> </p>

<h1 align="center">Gong MCP</h1>

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

<p align="center"> <a href="https://github.com/scandolo/gong-mcp/actions/workflows/ci.yml"><img src="https://github.com/scandolo/gong-mcp/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <img src="https://img.shields.io/badge/tools-20-7c5cff" alt="20 tools"> <img src="https://img.shields.io/badge/MCP-server-6a4bff" alt="MCP server"> <a href="./LICENSE"><img src="https://img.shields.io/github/license/scandolo/gong-mcp" alt="MIT license"></a> </p>

---

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

<p> <a href="https://github.com/scandolo/gong-mcp/releases/latest/download/gong-mcp.mcpb"> <img src="https://img.shields.io/badge/⬇%20Download%20the%20Gong%20MCP%20extension-.mcpb-7c5cff?style=for-the-badge" alt="Download the Gong MCP extension"> </a> </p>

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.

<p align="center"> <img src="assets/demo.gif" alt="Claude using Gong MCP to pull a call transcript and summarise renewal risk" width="720"> </p>

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

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

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.}