Gong MCP

🚀 Gong MCP Server

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

🚀 Quick Start

The Gong MCP Server is designed to offer access to the Gong API for retrieving call recordings and transcripts, allowing Claude to interact with Gong data via 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.

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

📚 Documentation

Configure Claude

1. Open the Claude Desktop settings.
2. Navigate to the MCP server 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 obtained from your .env file.

💻 Usage Examples

Basic Usage

List Calls

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

{
  name: "list_calls",
  description: "列出 Gong 通话，可选日期范围过滤。返回通话详细信息，包括 ID、标题、开始/结束时间、参与者和时长。",
  inputSchema: {
    type: "object",
    properties: {
      fromDateTime: {
        type: "string",
        description: "ISO 格式起始日期/时间（例如：2024-03-01T00:00:00Z）"
      },
      toDateTime: {
        type: "string",
        description: "ISO 格式结束日期/时间（例如：2024-03-31T23:59:59Z）"
      }
    }
  }
}

Retrieve Transcripts

Retrieve detailed transcripts for a specified call ID.

{
  name: "retrieve_transcripts",
  description: "检索指定通话 ID 的转录。返回详细转录，包括说话人 ID、主题和时间戳句子。",
  inputSchema: {
    type: "object",
    properties: {
      callIds: {
        type: "array",
      }
    }
  }
}

🔧 Technical Details

Prerequisites

• Node.js 18 or higher.
• Docker (optional, for containerized deployment).
• Gong API credentials (access key and secret).