<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`](https://github.com/scandolo/gong-mcp/releases/latest/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](#getting-your-gong-credentials)), 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](#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).

```bash
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`:

```json
{
  "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.

```text
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](https://github.com/scandolo/gong-mcp/releases/latest). To build it from source:

```bash
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](./LICENSE)

---

<sub>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.</sub>