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

Clone the repository
Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

Docker

Build the container:

docker build -t gong-mcp .

Configuring Claude

Open Claude Desktop settings
Navigate to the MCP Servers section
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"
  }
}

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

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

Configuring Claude

Open Claude Desktop settings

Navigate to the MCP Servers section

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

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"] } }