Skip to main content

Gong MCP Server

Create a powerful Model Context Protocol (MCP) server for Gong in minutes with our AI Gateway. This guide walks you through setting up seamless Gong integration with enterprise-grade security and instant OAuth authentication.

About Gong API​

Gong is the leading Revenue AI platform that captures and analyzes customer interactions across phone, web conferencing, and email. The Gong API provides comprehensive access to conversation data, enabling you to:

  • Call Recording & Transcription: Access recorded calls and their transcripts
  • Conversation Analytics: Retrieve insights from customer interactions
  • Deal Intelligence: Track opportunities and deal progression
  • User Management: Access user profiles and activity data
  • CRM Integration: Sync data with external CRM systems
  • Coaching Insights: Access scorecards and performance metrics
  • Library Management: Access shared call libraries and collections

Key Features​

  • REST API: RESTful endpoints for all Gong operations
  • OAuth 2.0: Secure authorization with granular scopes
  • Comprehensive Transcripts: Full call transcripts with speaker identification
  • Real-time Analytics: Conversation intelligence and insights
  • Multi-workspace Support: Enterprise-grade workspace management
  • CRM Sync: Bi-directional CRM data synchronization
  • Tracker Detection: Keyword and phrase tracking across calls
  • Action Item Extraction: Automatic identification of follow-ups

What You Can Do with Gong MCP Server​

The MCP server transforms Gong's API into a natural language interface, enabling AI agents to:

Call & Conversation Intelligence​

  • Call Analysis

    • "Get the transcript from yesterday's demo call with Acme Corp"
    • "Find all calls where competitors were mentioned this month"
    • "Show me calls with action items that haven't been followed up"
    • "Retrieve the longest calls from last week"

  • Transcript Search

    • "Find calls where pricing objections were raised"
    • "Search for mentions of 'enterprise plan' in recent calls"
    • "Get all calls discussing implementation timeline"

  • Conversation Insights

    • "What topics were discussed in the Q4 pipeline review?"
    • "Show talk-to-listen ratio for the sales team this quarter"
    • "Find calls with the highest engagement scores"

Sales Coaching & Performance​

  • Scorecard Analysis

    • "Get scorecard results for the sales team this month"
    • "Show coaching feedback for new SDRs"
    • "Compare call quality scores across regions"

  • Best Practices

    • "Find top-performing discovery calls to use as examples"
    • "Identify calls with successful objection handling"
    • "Get calls that led to closed-won deals"

Deal & Pipeline Intelligence​

  • Opportunity Tracking

    • "Show all calls associated with the Acme Corp deal"
    • "Get recent customer interactions for at-risk deals"
    • "Find calls from deals closing this quarter"

  • CRM Integration

    • "Sync call notes to Salesforce opportunities"
    • "Update CRM records with latest call outcomes"
    • "Get call context for upcoming meetings"

Analytics & Reporting​

  • Team Performance

    • "Generate call activity report for the sales team"
    • "Show meeting statistics for the past 30 days"
    • "Get user engagement metrics"

  • Trend Analysis

    • "Analyze competitor mention trends over time"
    • "Track talk patterns across the team"
    • "Identify common objections by product line"

Prerequisites​

  • Access to Cequence AI Gateway
  • Gong account with admin privileges
  • OAuth app creation permissions in Gong
  • Technical admin access for API configuration

Step 1: Create Gong OAuth App​

Before setting up the MCP server, you need to configure OAuth in Gong.

1.1 Access Gong API Settings​

  1. Log in to your Gong account as an admin
  2. Navigate to Company Settings → Ecosystem → API
  3. Click Create New Integration

1.2 Configure OAuth Application​

  1. Enter application details:

    • App Name: "AI Gateway MCP Integration"
    • Description: "MCP server integration for AI agents"

  2. Configure OAuth settings:

    • Redirect URI: 
      https://auth.aigateway.cequence.ai/v1/outbound/oauth/callback

  3. Select required scopes (see Available Scopes section)

1.3 Get Client Credentials​

  1. After creating the integration, note down:

    • Client ID
    • Client Secret

  2. Save these credentials securely for MCP server configuration

Step 2: Access AI Gateway Apps​

  1. Log in to your Cequence AI Gateway dashboard
  2. Navigate to Apps in the left sidebar
  3. You'll see the list of available third-party applications

Step 3: Find and Select Gong API​

  1. In the Apps section, browse through the Third-party category
  2. Look for Gong or use the search function
  3. Click on the Gong API card to view details

The Gong API card shows:

  • Number of available endpoints
  • Integration capabilities
  • Quick description of functionality

Step 4: Create MCP Server​

  1. Click the Create MCP Server button on the Gong API card
  2. You'll be redirected to the MCP Server creation wizard

Step 5: Configure API Endpoints​

In the App Configuration step:

  1. Base URL is pre-filled: https://api.gong.io
  2. Select API endpoints to expose to your MCP server:
    • Calls endpoints for recording and transcript access
    • Users endpoints for team member data
    • Stats endpoints for analytics
    • CRM endpoints for integration sync
  3. Click Next to proceed

Step 6: MCP Server Basic Setup​

Configure your MCP server details:

  1. MCP Server Name: Enter a descriptive name

    • Example: "Gong Revenue Intelligence"
    • This name will identify your server in the dashboard

  2. Description (Optional): Add details about the server's purpose

    • Example: "Call analytics and conversation intelligence for sales team"

  3. Production Mode: Toggle based on your needs

    • ON for production environments
    • OFF for development/testing

  4. Click Next to continue

Step 7: Configure Authentication​

This is where you'll use your Gong OAuth credentials:

  1. Authentication Type: Select OAuth 2.0

  2. Fill in the OAuth configuration:

    • Authorization URL: 
      https://app.gong.io/oauth2/authorize
    • Token URL: 
      https://app.gong.io/oauth2/generate-customer-token
    • Client ID: Paste from Gong API settings
    • Client Secret: Paste from Gong API settings
    • Redirect URI: 
      https://auth.aigateway.cequence.ai/v1/outbound/oauth/callback

  3. Scopes: Select from the available Gong scopes (see next section)

Available Gong OAuth Scopes​

Configure the appropriate scopes based on your application needs:

Call & Recording Access​

  • api:calls:read:basic

    • Read basic call metadata
    • Access call lists and summaries
    • View call participants

  • api:calls:read:extensive

    • Read detailed call data
    • Access call structure and topics
    • View trackers and insights

  • api:calls:read:transcript

    • Read call transcripts
    • Access speaker-identified text
    • View conversation flow

  • api:calls:read:media-url

    • Access call recording URLs
    • Download audio/video files
    • Stream media content

  • api:calls:create

    • Upload new call recordings
    • Create call metadata
    • Add call media files

User & Workspace Management​

  • api:users:read

    • Read user profiles
    • Access user activity data
    • View team member information

  • api:workspaces:read

    • Read workspace configuration
    • Access workspace settings
    • View workspace members

  • api:provisioning:read

    • Read provisioning data
    • Access user provisioning status

  • api:provisioning:read-write

    • Full provisioning access
    • Manage user provisioning

  • api:permission-profile:read

    • Read permission profiles
    • View access configurations

  • api:permission-profile:write

    • Modify permission profiles
    • Update access settings

Analytics & Statistics​

  • api:stats:scorecards

    • Read scorecard statistics
    • Access coaching metrics

  • api:stats:interaction

    • Read interaction statistics
    • Access engagement metrics

  • api:stats:user-actions

    • Read user action statistics
    • View activity metrics

  • api:stats:user-actions:detailed

    • Detailed user action data
    • Comprehensive activity logs

CRM Integration​

  • api:crm:get-objects

    • Read CRM objects
    • Access synced data

  • api:crm:upload

    • Upload CRM data
    • Sync external records

  • api:crm:schema

    • Access CRM schema
    • View field mappings

  • api:crm:integrations:read

    • Read CRM integrations
    • View sync status

  • api:crm:integration:register

    • Register CRM integrations
    • Configure sync settings

  • api:crm:integration:delete

    • Remove CRM integrations
    • Delete sync configurations

  • api:crm-calls:manual-association:read

    • Read manual call-CRM associations
    • View linked records

Content & Settings​

  • api:library:read

    • Read call library content
    • Access shared collections

  • api:settings:scorecards:read

    • Read scorecard settings
    • View scoring criteria

  • api:settings:trackers:read

    • Read tracker settings
    • View keyword configurations

  • api:call-outcomes:read

    • Read call outcome data
    • Access disposition info

Tasks & Workflows​

  • api:tasks:read

    • Read task data
    • Access action items

  • api:tasks:write

    • Create and update tasks
    • Manage action items

  • api:flows:read

    • Read workflow data
    • Access flow configurations

  • api:flows:write

    • Create and update workflows
    • Manage flow settings

Meetings​

  • api:meetings:user:create

    • Create meeting records
    • Schedule meetings

  • api:meetings:user:update

    • Update meeting data
    • Modify meeting details

  • api:meetings:user:delete

    • Delete meeting records
    • Remove meetings

  • api:meetings:integration:status

    • Read integration status
    • View sync state

Data & Privacy​

  • api:data-privacy:read

    • Read data privacy settings
    • Access retention policies

  • api:data-privacy:delete

    • Delete user data
    • Manage data retention

  • api:digital-interactions:write

    • Write digital interaction data
    • Log external interactions

  • api:engagement-data:write

    • Write engagement data
    • Update interaction metrics

System & Logs​

  • api:logs:read

    • Read system logs
    • Access audit trails

  • api:integration-settings:write

    • Configure integration settings
    • Update API configurations

For Call Analytics & Transcripts:

api:calls:read:basic
api:calls:read:extensive
api:calls:read:transcript
api:users:read

For Sales Coaching:

api:calls:read:basic
api:calls:read:extensive
api:calls:read:transcript
api:stats:scorecards
api:settings:scorecards:read
api:library:read

For CRM Integration:

api:calls:read:basic
api:crm:get-objects
api:crm:upload
api:crm:integrations:read

For Full Access:

api:calls:read:basic
api:calls:read:extensive
api:calls:read:transcript
api:calls:read:media-url
api:users:read
api:stats:scorecards
api:stats:interaction
api:library:read
api:tasks:read

Step 8: Configure Security​

Set up API protection features:

  1. API Protection: Toggle ON to enable

    • Protects against bot attacks, DDoS, and threats
    • Monitors for suspicious activity
    • Rate limiting and anomaly detection

  2. Protection Features (when enabled):

    • Auto-scaling protection
    • Managed infrastructure
    • Built-in monitoring
    • Zero maintenance required

  3. Click Next to continue

Step 9: Choose Deployment Method​

Select your deployment preference:

  • Fully managed deployment
  • Automatic scaling and monitoring
  • Built-in high availability
  • Features included:
    • Auto-scaling
    • Managed infrastructure
    • Built-in monitoring
    • Zero maintenance

Option B: Deploy with Helm Chart​

  • Self-managed Kubernetes deployment
  • Full control over infrastructure
  • Requires:
    • Kubernetes cluster
    • Helm 3.x installed
    • Container registry access

Click Next after selecting your deployment method.

Step 10: Review and Deploy​

Review your MCP server configuration:

  • MCP Server Name: Your chosen name
  • Base URL: https://api.gong.io
  • Selected Endpoints: Number of endpoints selected
  • Authentication: OAuth 2.0 (Configured)
  • API Protection: Enabled/Disabled
  • Deployment: Cequence Cloud or Helm

Click Create & Deploy to finalize the setup.

Step 11: Post-Deployment Setup​

After successful deployment:

  1. Note the MCP Server URL provided

  2. Test the OAuth flow:

    • Click "Test Connection"
    • You'll be redirected to Gong authorization
    • Authorize the application
    • Confirm successful connection

  3. Configure AI Agents:

    • The MCP server is now available for AI agent connections
    • Use the provided server URL in your AI agent configuration

Using Your Gong MCP Server​

Setup Instructions:

Common Use Cases​

Sales Enablement​

  • Call coaching and feedback
  • Best practice identification
  • New rep onboarding
  • Talk track optimization

Revenue Operations​

  • Pipeline health analysis
  • Deal risk identification
  • Forecast accuracy improvement
  • Win/loss analysis

Customer Success​

  • Customer sentiment tracking
  • Churn risk identification
  • Expansion opportunity detection
  • Health score monitoring

Product & Marketing​

  • Voice of customer insights
  • Competitive intelligence
  • Feature request tracking
  • Messaging effectiveness

Security Best Practices​

  1. Scope Management:

    • Only request necessary scopes
    • Use read-only scopes when possible
    • Regularly audit scope usage

  2. Token Security:

    • Never expose tokens in code
    • Rotate tokens periodically
    • Use environment variables

  3. Data Access:

    • Limit access to sensitive call data
    • Implement data retention policies
    • Monitor API access patterns

  4. Compliance:

    • Ensure GDPR/CCPA compliance
    • Respect call recording consent
    • Follow data privacy regulations

Troubleshooting​

Common Issues​

  1. OAuth Authorization Failed

    • Verify redirect URLs match exactly
    • Check admin privileges in Gong
    • Ensure OAuth app is properly configured

  2. Missing Scopes Error

    • Add required scopes in Gong API settings
    • Update MCP server configuration
    • Re-authorize the application

  3. Rate Limiting

    • Gong has API rate limits
    • Implement exponential backoff
    • Use pagination for large datasets

  4. Transcript Not Available

    • Calls may take time to process
    • Check call processing status
    • Verify transcript scope is enabled

Filter Constraints​

When using the /v2/calls/extensive or /v2/calls/transcript endpoints:

  • callIds and workspaceId are mutually exclusive - you cannot provide both in the same request
  • Use either callIds to filter specific calls, OR workspaceId to filter by workspace
  • Date range filters (fromDateTime, toDateTime) can be combined with either

Getting Help​