Gong MCP Server
An MCP (Model Context Protocol) server that provides access to your Gong.io data. Query calls, retrieve transcripts, and list users directly from Claude or any MCP-compatible client.
Features
- List Calls - Browse calls with date filtering and pagination
- Get Call Details - Retrieve comprehensive call information including participants, topics, trackers, and action items
- Get Transcripts - Access full speaker-attributed, timestamped transcripts
- List Users - View all users in your Gong workspace
- Search Calls - Find calls by date range, host, or specific IDs
Prerequisites
- Node.js 24+ (or Bun)
- Gong API credentials (Access Key and Secret)
Getting Gong API Credentials
- Log into Gong as an admin
- Go to Company Settings → Ecosystem → API
- Click Create API Key
- Save both the Access Key and Secret (the secret is only shown once)
Installation
From npm
npm install -g gongio-mcp
From source
git clone https://github.com/your-username/gongio-mcp.git
cd gongio-mcp
npm install
npm run build
Configuration
Set your Gong credentials as environment variables:
export GONG_ACCESS_KEY="your-access-key"
export GONG_ACCESS_KEY_SECRET="your-secret-key"
Usage
Running the Server
gongio-mcp
# or if installed locally:
npm start
With Claude Desktop
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"gong": {
"command": "npx",
"args": ["gongio-mcp"],
"env": {
"GONG_ACCESS_KEY": "your-access-key",
"GONG_ACCESS_KEY_SECRET": "your-secret-key"
}
}
}
}
Available Tools
list_calls
List Gong calls with optional date filtering.
Parameters:
fromDateTime(optional): Start date in ISO 8601 formattoDateTime(optional): End date in ISO 8601 formatcursor(optional): Pagination cursor
get_call_details
Get detailed information about specific calls.
Parameters:
callIds(required): Array of call IDs
get_transcripts
Retrieve full transcripts for specified calls.
Parameters:
callIds(required): Array of call IDs
list_users
List all Gong users in your workspace.
Parameters:
cursor(optional): Pagination cursor
search_calls
Search for calls with various filters.
Parameters:
fromDateTime(optional): Start date in ISO 8601 formattoDateTime(optional): End date in ISO 8601 formatprimaryUserIds(optional): Array of user IDs to filter by hostcallIds(optional): Array of specific call IDscursor(optional): Pagination cursor
Available Resources
gong://users
Returns a JSON list of all users in your Gong workspace.
Example Prompts
Once connected to Claude, you can ask things like:
- "List my Gong calls from last week"
- "Get the transcript for call ID abc123"
- "Who are all the users in our Gong workspace?"
- "Show me details for the calls I had yesterday"
- "Find all calls hosted by user xyz"
Development
# Run with hot reload (requires Bun)
bun run dev
# Type check
npm run typecheck
# Build for distribution
npm run build
License
MIT