
gongio-mcp
io.github.JustinBeckwith/gongio-mcp
MCP server for Gong.io - access calls, transcripts, and users
Documentation
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
gongio-mcpnpm install gongio-mcp