justinbeckwith/gongio-mcp

21 stars 0 forks Качество 90 Тренд 90

MCP server for Gong.io - access calls, transcripts, and users

Обзор

An MCP (Model Context Protocol) server that provides access to your Gong.io data. Query calls, transcripts, users, keyword trackers, and more directly from Claude or any MCP-compatible client. search_calls can return a lot of data. Under the hood it: - Auto-paginates up to (50 API pages) per query - Applies client-side filters (participant, customer, tracker, duration, etc.) after pagination - Returns a rich per-call format (metadata + summary + topics + participants) by default - If the formatted output would exceed (default 50000 chars, configurable via env var), the tool with a warning. You still get every call ID and title — drill in with get_call_summary on specific ones. - include: ["outline"] is (~80KB per call). Avoid it in multi-call searches. - Tracker data is filtered to only show trackers matching your trackers filter (or non-zero trackers if no filter) — no more walls of (0x) noise. 1. Tighten fromDateTime / toDateTime 2. Add scope: "External" or scope: "Internal" 3.

README

Gong MCP Server

An MCP (Model Context Protocol) server that provides access to your Gong.io data. Query calls, transcripts, users, keyword trackers, and more directly from Claude or any MCP-compatible client.

Tools Quick Reference

Tool	Description
`list_calls`	List calls with date/workspace filtering
`get_call`	Get metadata for a specific call
`get_call_summary`	AI summary: key points, topics, action items
`get_call_transcript`	Full speaker-attributed transcript (paginated)
`search_calls`	Rich call search — participant, customer, tracker, scope, duration, title, and more
`search_calls_by_account`	Find calls involving a specific account/company by email domain
`search_calls_by_opportunity`	Find calls linked to specific CRM Opportunities
`search_transcripts`	Free-text keyword search across transcript sentences
`get_trackers`	List keyword trackers (competitors, topics, etc.)
`list_workspaces`	List workspaces and get IDs for use in other tools
`list_library_folders`	List public call library folders
`get_library_folder_calls`	Get calls saved in a specific library folder
`get_user`	Get a specific user’s profile
`search_users`	Search/filter users by IDs or creation date
`list_users`	List all workspace users

Response Size & Context Limits

search_calls can return a lot of data. Under the hood it:

Auto-paginates up to ~5000 calls (50 API pages) per query
Applies client-side filters (participant, customer, tracker, duration, etc.) after pagination
Returns a rich per-call format (metadata + summary + topics + participants) by default

Guardrails built in:

If the formatted output would exceed MAX_MCP_OUTPUT_LENGTH (default 50000 chars, configurable via env var), the tool automatically falls back to a compact table with a warning. You still get every call ID and title — drill in with get_call_summary on specific ones.
include: ["outline"] is expensive (~80KB per call). Avoid it in multi-call searches.
Tracker data is filtered to only show trackers matching your trackers filter (or non-zero trackers if no filter) — no more walls of (0x) noise.

If your query hits the output cap, narrow it:

Tighten fromDateTime / toDateTime
Add scope: "External" or scope: "Internal"
Add minDuration: 600 to skip short no-shows
Add customerName or trackers filter
Drop heavy include options like outline

Prerequisites

Node.js 18+ or Docker
Gong API credentials (Access Key and Secret)

Available Tools

Available Resources

Example Prompts

Once connected to Claude, you can ask:

“List my Gong calls from last week”
“Get the details for call 123456789”
“Show me a summary of call 123456789”
“Get the transcript for call 789012”
“What workspaces do we have in Gong?”
“What keywords is Gong tracking for competitors?”
“What call library folders do we have in Gong?”
“Show me the calls in the ‘Best Discovery Calls’ library folder”
“Who are all the users in our Gong workspace?”
“Search for calls hosted by Justin (user ID 232255198215877499) in July 2025”
“Look up these user IDs: 111, 222, 333”
“Show me all calls from the past 60 days with anyone at acme.com or acme.io”
“Find every call attached to opportunity 006xxxxx”
“Find Q3 calls where prospects mentioned Klaviyo or Braze, narrowed to John’s calls”

Contributing

Interested in contributing? Check out CONTRIBUTING.md for development setup, testing instructions, and guidelines.

The repository includes gong-openapi.json — a local copy of the Gong API OpenAPI spec. It’s useful as a reference when adding new tools: use it to look up endpoint paths, parameter names, and response shapes without leaving your editor. The latest spec can be downloaded from the Gong API documentation.

View this README on GitHub

Установка

npx gongio-mcp

Конфигурация

{
  "mcpServers": {
    "gong": {
      "command": "npx",
      "args": ["gongio-mcp"],
      "env": {
        "GONG_ACCESS_KEY": "your-access-key",
        "GONG_ACCESS_KEY_SECRET": "your-secret-key"
      }
    }
  }
}