MCP server that gives Claude Code access to Gong call data
Gong MCP Server
Give Claude AI direct access to your Gong call data.
This server connects Claude Code (Anthropic's AI coding assistant) to your Gong account, letting you analyze sales calls, search transcripts, and extract insights using natural language.
What Can You Do With This?
Once connected, just ask Claude things like:
- "Show me all calls from last month that were over 30 minutes"
- "Find calls where customers mentioned pricing concerns"
- "Get the AI summary for my call with Acme Corp"
- "What topics came up most in calls this week?"
- "Show me the transcript from yesterday's demo call"
Claude handles all the API calls behind the scenes - you just ask questions in plain English.
Quick Start Guide
What You'll Need
- Claude Code - Anthropic's CLI tool (Get it here)
- Node.js 18+ - JavaScript runtime (Download)
- Gong API credentials - Access Key and Secret from your Gong admin
Step 1: Get Your Gong API Credentials
- Log into Gong as an admin
- Go to Admin Center → Settings → Ecosystem → API
- Click Get API Key
- Save your Access Key and Access Key Secret somewhere safe
Step 2: Download and Build
Open your terminal and run:
# Download the code
git clone https://github.com/brownbrawh/gong-mcp-server.git
cd gong-mcp-server
# Install dependencies
npm install
# Build
npm run build
Step 3: Connect to Claude Code
Run this command (replace the placeholders with your actual credentials):
claude mcp add gong -s user \
-e GONG_ACCESS_KEY=your_access_key_here \
-e GONG_ACCESS_SECRET=your_access_secret_here \
-e GONG_API_BASE_URL=https://your-instance.api.gong.io \
-- node /path/to/gong-mcp-server/dist/index.js
Note: Replace
/path/to/gong-mcp-serverwith the actual path where you downloaded the code.
Step 4: Verify It's Working
claude mcp list
You should see gong in the list. Now open Claude Code and try asking about your Gong data!
Available Tools
This server gives Claude access to 12 tools:
| Category | Tools | What They Do |
|----------|-------|--------------|
| Calls | gong_list_calls, gong_get_call, gong_search_calls | List, view, and search your calls |
| Transcripts | gong_get_transcripts, gong_get_transcript_text, gong_search_transcripts | Read transcripts and search for keywords |
| AI Insights | gong_get_ai_insights | Get Gong's AI-generated summaries and key points |
| Users | gong_list_users, gong_get_user, gong_get_user_stats | View team members and their stats |
| Trackers | gong_get_trackers | See your configured keyword trackers |
| Utility | gong_test_connection | Verify your connection is working |
Example Workflows
Analyze Your Recent Calls
You: "Get a summary of all my calls from the last 2 weeks"
Claude: I found 47 calls totaling 32 hours. Here's the breakdown:
- 28 discovery calls (avg 35 min)
- 12 demo calls (avg 52 min)
- 7 follow-up calls (avg 18 min)
...
Search for Specific Topics
You: "Find calls where prospects mentioned competitors"
Claude: I found 13 calls mentioning competitors. Here are the key quotes:
- Call with Acme Corp: "We're also looking at HubSpot..."
- Call with Beta Inc: "How do you compare to Salesforce?"
...
Get AI Insights
You: "What were the key points from my call with John at TechCorp?"
Claude: Here's the AI summary:
- Main pain point: Manual data entry taking 10+ hours/week
- Decision timeline: Q2 budget approval
- Next steps: Send pricing proposal by Friday
...
Features
- Smart Pagination - Handles large datasets without overwhelming Claude's context
- Duration Filtering - Focus on meaningful calls (e.g., only 20+ minute calls)
- Keyword Search - Find specific topics across all your transcripts
- Automatic Rate Limiting - Respects Gong's API limits (3 requests/second)
- Retry Logic - Automatically retries failed requests
- Full TypeScript - Type-safe and well-documented code
Troubleshooting
"Authentication failed"
- Double-check your Access Key and Secret
- Make sure your API key hasn't expired
- Verify API access is enabled in your Gong account
"Access denied"
- Your API key may not have the right permissions
- Contact your Gong admin to check API permissions
Claude's response is cut off
- Use filters to reduce the data (date range, duration, etc.)
- Ask for summaries first, then drill into specific calls
How It Works
This is an MCP (Model Context Protocol) server. MCP is an open standard that lets AI assistants like Claude securely connect to external data sources.
When you ask Claude about your Gong data, it uses this server to make API calls to Gong, then presents the results in a conversational format.
You → Claude Code → Gong MCP Server → Gong API → Your Data
Your credentials stay on your machine - they're never sent to Claude's servers.
Project Structure
gong-mcp-server/
├── src/
│ ├── index.ts # Main server entry point
│ ├── client.ts # Gong API client
│ ├── tools.ts # Tool definitions
│ └── types.ts # TypeScript types
├── package.json # Dependencies
└── tsconfig.json # TypeScript config
License
MIT License - free to use, modify, and distribute.
Author
Built by Shireesh for the Claude Code community.
Changelog
v1.2.0 (January 2026)
- Fixed tracker names (now shows actual names instead of "Unknown")
- Added support for all call direction types
v1.1.0 (January 2026)
- Added transcript keyword search
- Added AI insights tool
- Added duration filtering
- Added smart pagination
v1.0.0 (January 2026)
- Initial release with 12 tools