- What You’ll Get
- Prerequisites
- Choose Your Integration Approach
- Option 1: MCP Server Integration (Recommended)
- Option 2: Direct Gong API Integration
- MCP Server Integration Setup
- Authentication Details
- How Gong Authentication Works
- Security Best Practices
- Troubleshooting
- ”Gong tools not available”
- ”Authentication failed” or 401 errors
- ”Rate limit exceeded” or 429 errors
- No calls returned from gong_list_calls
- Example Workflows
- List Recent Calls
- Create Mind from Call
- Analyze Call Patterns
- Bulk Mind Creation
- Next Steps
- Official Documentation
Gong Integration Setup
Access Sales Call Transcripts
Connect Gong to pull sales call recordings and transcripts directly into your AI workflows. Create minds from customer conversations without manual file downloads.
What You’ll Get
When you connect Gong to your MCP server, you unlock 3 additional tools:
- gong_list_calls - List call recordings with date filtering and metadata
- gong_get_transcript - Get detailed transcripts with speaker names and emails
- gong_get_call_details - Get participant details, topics, structure, and speaker stats
These tools work alongside the 8 core Mind Reasoner tools, giving you seamless access to your sales call data.
Prerequisites
Gong Account Requirements
To generate API credentials, you need Technical Administrator role in your Gong account. If you don’t have this role, contact your Gong administrator.
Choose Your Integration Approach
You have two options for working with Gong data:
Option 1: MCP Server Integration (Recommended)
Best for: AI-driven workflows, natural language access, no coding
Benefits:
- Access Gong calls through simple AI commands
- Automatic authentication and error handling
- Seamless integration with Mind Reasoner mind creation
- Works in Claude Desktop, Claude Code, and other MCP clients
Setup: Follow the steps below to add Gong credentials to your MCP server
Option 2: Direct Gong API Integration
Best for: Custom applications, specialized workflows, full API control
Benefits:
- Complete control over API calls and data processing
- Build custom integrations with other services
- Implement specialized business logic
Resources:
- Gong API Documentation
- Gong API Authentication Guide
- Mind Reasoner REST API - Combine with Gong data as needed
MCP Server Integration Setup
Get Your Gong API Credentials
1. Log in to Gong
Navigate to app.gong.io
2. Access API Settings
Go to Settings → Ecosystem → API (or visit app.gong.io/company/api directly)
3. Generate Access Key
Click “Create” or “Generate New Access Key”
You’ll receive two credentials:
- Access Key (similar to a username)
- Access Key Secret (similar to a password)
Save Your Secret Immediately
The Access Key Secret is shown only once. Copy and save it securely immediately—you cannot retrieve it later. If you lose it, you’ll need to generate a new key pair.
Configure Your MCP Server
The configuration method depends on how you’re running the MCP server:
For Local/Stdio Mode (Claude Desktop, Claude Code CLI)
Add these environment variables to your configuration:
For Hosted/HTTP Mode (Serverless, Custom Clients)
Pass credentials as HTTP headers with each request:
Per-Request Authentication (HTTP Mode)
In HTTP mode, you can provide different Gong credentials for each request. This is useful for multi-tenant applications or supporting multiple Gong accounts.
Integration Active
Gong is now connected to your MCP server. You can access sales call transcripts directly through natural language commands in your AI assistant.
Authentication Details
How Gong Authentication Works
Gong uses HMAC-SHA256 signature-based authentication for API security:
- Each API request generates a signature using your Access Key Secret
- The signature is computed from: HTTP method + URL path + timestamp + request body
- The Access Key and signature are sent in the request headers
- Gong validates the signature to authenticate the request
This ensures that even if someone intercepts your Access Key, they cannot make valid API requests without your Access Key Secret.
Security Best Practices
Protect Your Gong Credentials
Your Gong credentials provide access to all sales call recordings and transcripts in your account.
Security checklist:
- Never share Access Key Secret in messages or screenshots
- Don’t commit credentials to version control (use .env files, add to .gitignore)
- Use environment variables for local development
- Rotate credentials periodically from Gong settings
- If compromised, immediately revoke the key and generate a new one
- Audit API key usage regularly in Gong settings
Troubleshooting
”Gong tools not available”
Possible causes:
- Credentials not configured
- Environment variables not loaded
- MCP client not restarted after configuration
Solutions:
- Verify environment variables are set correctly
- Check for typos in variable names (
GONG_ACCESS_KEY,GONG_ACCESS_SECRET) - Restart your MCP client (Claude Desktop, Claude Code)
- Ask: “What MCP tools are available?” to see current tool list
”Authentication failed” or 401 errors
Possible causes:
- Incorrect Access Key or Access Key Secret
- Credentials expired or revoked
- Signature generation error
Solutions:
- Verify credentials match exactly what’s shown in Gong settings
- Check for extra spaces or line breaks in credentials
- Generate a new Access Key pair in Gong settings
- Ensure you copied the Access Key Secret when it was first shown
- Verify your Gong account has API access enabled
”Rate limit exceeded” or 429 errors
Cause: Too many API requests to Gong in a short time period
Solutions:
- Wait for the time specified in the error message
- Reduce the frequency of calls list queries
- Use date filtering to reduce result set sizes
- Contact Gong support to discuss rate limit increases for your account
No calls returned from gong_list_calls
Possible causes:
- No calls in the specified date range
- User permissions don’t include call access
- Gong account has no recorded calls
Solutions:
- Try a wider date range
- Verify your Gong account has recorded calls
- Check user permissions in Gong settings
- Test with no date filter to see if any calls are accessible
Example Workflows
Once Gong is connected, try these workflows:
List Recent Calls
AI uses: gong_list_calls with date filtering
Create Mind from Call
AI workflow:
- Lists calls and finds the matching call
- Retrieves full transcript with
gong_get_transcript - Creates a new mind with
create_mind - Uploads transcript data
- Creates snapshot and waits for training
Analyze Call Patterns
AI uses: gong_list_calls + gong_get_call_details for each call
Bulk Mind Creation
AI orchestrates:
- Lists all calls from last 30 days
- Gets call details for each to check speaker time
- Creates minds for qualifying speakers
- Uploads transcripts filtered to each speaker’s segments
Next Steps
Explore Gong Tools
Learn about all 3 Gong tools, their parameters, and detailed usage examples.
Gong Tools Reference →Add More Integrations
Connect Fathom or Fireflies for access to even more meeting transcripts.
All Integrations →Complete Workflows
See end-to-end examples of creating minds from Gong data.
Quickstart Guide →Official Documentation
For direct API integration or advanced use cases:
- Gong API Documentation - Complete API reference
- Gong API Authentication - Detailed auth guide
- Gong API Rate Limits - Understanding limits
- Gong Help Center - General Gong support
