Gong

by kenazk

15 stars
395 downloads
Not rated
GitHub

About

Integrates with Gong's API to access call recordings and transcripts, enabling analysis of sales conversations and customer interactions with date filtering and speaker identification capabilities.

Details

Author
kenazk
Repository
kenazk/gong-mcp
GitHub stars
15
Downloads
395
License
MIT License
Categories
Design, Developer Tools, AI, Infrastructure, Frontend, Security, API, Other

- List Gong calls with optional date range filtering
- Retrieve detailed transcripts for specific calls
- Secure authentication using Gong's API credentials
- Standardized MCP interface for easy integration with Claude

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Gong
    Command (node, npx, python, etc.) docker
    Arguments
    • Argument 1 run
    • Argument 2 -it
    • Argument 3 --rm
    • Argument 4 gong-mcp
    Environment
    • GONG_ACCESS_KEY your_access_key_here
    • GONG_ACCESS_SECRET your_access_secret_here

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Open Claude Desktop settings
2. Navigate to the MCP Servers section
3. Add a new server with the following configuration:

{
  "command": "docker",
  "args": [
    "run",
    "-it",
    "--rm",
    "gong-mcp"
  ],
  "env": {
    "GONG_ACCESS_KEY": "your_access_key_here",
    "GONG_ACCESS_SECRET": "your_access_secret_here"
  }
}

4. Replace the placeholder credentials with your actual Gong API credentials from your .env file

list_calls

List Gong calls with optional date range filtering. Returns call details including ID, title, start/end times, participants, and duration. Parameters: fromDateTime (string, optional), toDateTime (string, optional)

retrieve_transcripts

Retrieve transcripts for specified call IDs. Returns detailed transcripts including speaker IDs, topics, and timestamped sentences. Parameters: callIds (array of strings, required)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "gong": {
            "env": {
                "GONG_ACCESS_KEY": "your_access_key_here",
                "GONG_ACCESS_SECRET": "your_access_secret_here"
            },
            "args": [
                "run",
                "-it",
                "--rm",
                "gong-mcp"
            ],
            "command": "docker"
        }
    }
}

Linux

{
    "env": {
        "GONG_ACCESS_KEY": "your_access_key_here",
        "GONG_ACCESS_SECRET": "your_access_secret_here"
    },
    "args": [
        "run",
        "-it",
        "--rm",
        "gong-mcp"
    ],
    "command": "docker"
}

Macos

{
    "env": {
        "GONG_ACCESS_KEY": "your_access_key_here",
        "GONG_ACCESS_SECRET": "your_access_secret_here"
    },
    "args": [
        "run",
        "-it",
        "--rm",
        "gong-mcp"
    ],
    "command": "docker"
}

Windows

{
    "env": {
        "GONG_ACCESS_KEY": "your_access_key_here",
        "GONG_ACCESS_SECRET": "your_access_secret_here"
    },
    "args": [
        "run",
        "-it",
        "--rm",
        "gong-mcp"
    ],
    "command": "docker"
}

Gong MCP Server

A Model Context Protocol (MCP) server that provides access to Gong's API for retrieving call recordings and transcripts. This server allows Claude to interact with Gong data through a standardized interface.

Features

- List Gong calls with optional date range filtering
- Retrieve detailed transcripts for specific calls
- Secure authentication using Gong's API credentials
- Standardized MCP interface for easy integration with Claude

Prerequisites

- Node.js 18 or higher
- Docker (optional, for containerized deployment)
- Gong API credentials (Access Key and Secret)

Installation

Local Development

1. Clone the repository
2. Install dependencies:

   npm install

3. Build the project:
   npm run build

Docker

Build the container:

docker build -t gong-mcp .

Configuring Claude

1. Open Claude Desktop settings
2. Navigate to the MCP Servers section
3. Add a new server with the following configuration:

{
  "command": "docker",
  "args": [
    "run",
    "-it",
    "--rm",
    "gong-mcp"
  ],
  "env": {
    "GONG_ACCESS_KEY": "your_access_key_here",
    "GONG_ACCESS_SECRET": "your_access_secret_here"
  }
}

4. Replace the placeholder credentials with your actual Gong API credentials from your .env file

Available Tools

List Calls

Retrieves a list of Gong calls with optional date range filtering.

{
  name: "list_calls",
  description: "List Gong calls with optional date range filtering. Returns call details including ID, title, start/end times, participants, and duration.",
  inputSchema: {
    type: "object",
    properties: {
      fromDateTime: {
        type: "string",
        description: "Start date/time in ISO format (e.g. 2024-03-01T00:00:00Z)"
      },
      toDateTime: {
        type: "string",
        description: "End date/time in ISO format (e.g. 2024-03-31T23:59:59Z)"
      }
    }
  }
}

Retrieve Transcripts

Retrieves detailed transcripts for specified call IDs.

{
  name: "retrieve_transcripts",
  description: "Retrieve transcripts for specified call IDs. Returns detailed transcripts including speaker IDs, topics, and timestamped sentences.",
  inputSchema: {
    type: "object",
    properties: {
      callIds: {
        type: "array",
        items: { type: "string" },
        description: "Array of Gong call IDs to retrieve transcripts for"
      }
    },
    required: ["callIds"]
  }
}

License

MIT License - see LICENSE file for details

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.