Gong Integration Setup

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

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

$
# Required - Mind Reasoner
$
MIND_REASONER_API_KEY=your_mind_reasoner_key
$
$
# Optional - Gong Integration
$
GONG_ACCESS_KEY={{GONG_ACCESS_KEY}}
$
GONG_ACCESS_SECRET={{GONG_ACCESS_SECRET}}

$
# Required
$
Authorization: Bearer YOUR_MIND_REASONER_KEY
$
$
# Optional - Gong
$
X-Gong-Access-Key: {{GONG_ACCESS_KEY}}
$
X-Gong-Access-Secret: {{GONG_ACCESS_SECRET}}

$
# Restart Claude Desktop or Claude Code
$
# The Gong tools will be available automatically

"What Gong tools do you have access to?"

"Show me my last 5 Gong calls from this week"

Authentication Details

How Gong Authentication Works

Gong uses HMAC-SHA256 signature-based authentication for API security:

1. Each API request generates a signature using your Access Key Secret
2. The signature is computed from: HTTP method + URL path + timestamp + request body
3. The Access Key and signature are sent in the request headers
4. 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

Troubleshooting

”Gong tools not available”

Possible causes:

• Credentials not configured
• Environment variables not loaded
• MCP client not restarted after configuration

Solutions:

1. Verify environment variables are set correctly
2. Check for typos in variable names (GONG_ACCESS_KEY, GONG_ACCESS_SECRET)
3. Restart your MCP client (Claude Desktop, Claude Code)
4. 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:

1. Verify credentials match exactly what’s shown in Gong settings
2. Check for extra spaces or line breaks in credentials
3. Generate a new Access Key pair in Gong settings
4. Ensure you copied the Access Key Secret when it was first shown
5. 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:

1. Wait for the time specified in the error message
2. Reduce the frequency of calls list queries
3. Use date filtering to reduce result set sizes
4. 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:

1. Try a wider date range
2. Verify your Gong account has recorded calls
3. Check user permissions in Gong settings
4. Test with no date filter to see if any calls are accessible

Example Workflows

Once Gong is connected, try these workflows:

List Recent Calls

"Show me my last 10 Gong calls from this month"

AI uses: gong_list_calls with date filtering

Create Mind from Call

"Create a mind from my Gong call with Sarah Johnson from last week"

AI workflow:

1. Lists calls and finds the matching call
2. Retrieves full transcript with gong_get_transcript
3. Creates a new mind with create_mind
4. Uploads transcript data
5. Creates snapshot and waits for training

Analyze Call Patterns

"Get details about my top 3 longest calls this month,
 including speaker stats and topics discussed"

AI uses: gong_list_calls + gong_get_call_details for each call

Bulk Mind Creation

"Create minds for all participants in my Gong calls
 from the last 30 days who spoke for more than 10 minutes"

AI orchestrates:

1. Lists all calls from last 30 days
2. Gets call details for each to check speaker time
3. Creates minds for qualifying speakers
4. Uploads transcripts filtered to each speaker’s segments

Next Steps

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