Gong MCP

MCP integration for Gong API, enabling AI assistants to interact with Gong call recordings, transcripts, and analytics.

Features

Authentication via secure Basic Auth
Access to calls, transcripts, users, and more
Compatible with Cursor AI assistant
Includes brief generation capability

Prerequisites

Node.js >= 20.0.0
pnpm (recommended) or npm
Gong API credentials (Access Key and Secret)

Setup

Clone this repository
Install dependencies:
```
pnpm install
```
Build the TypeScript code:
```
pnpm build
```

Configure your global Cursor MCP config at ~/.cursor/mcp.json with your Gong credentials:

{
  "mcpServers": {
    "gong-mcp": {
      "type": "stdio",
      "command": "/opt/homebrew/bin/node",
      "args": ["/path/to/gong-mcp/build/index.js"],
      "cwd": "/path/to/gong-mcp",
      "environment": {
        "GONG_ACCESS_KEY": "your-access-key",
        "GONG_SECRET": "your-secret"
      }
    }
  }
}

Environment Variables

The following environment variables are required:

GONG_ACCESS_KEY: Your Gong API access key
GONG_SECRET: Your Gong API secret

These can be set either in your environment or in the Cursor MCP config.

Documentation

Main Documentation - Detailed API and usage documentation
Sample Requests - Example API requests and responses

Development

Available npm scripts:

pnpm build        # Build the TypeScript code
pnpm dev          # Watch mode for development
pnpm test         # Run all tests
pnpm test:smoke   # Run smoke tests only
pnpm lint         # Run ESLint

Testing

Run the smoke tests to validate your setup:

pnpm test:smoke

Note: Make sure to have GONG_ACCESS_KEY and GONG_SECRET environment variables set before running tests.

Usage with Cursor

Once configured in your global Cursor MCP settings, the AI assistant can:

Retrieve call recordings and transcripts
Search for calls by date range or participants
Access user information
Generate briefs for deals/accounts
Analyze call patterns and metrics

gong-mcp