> For the complete documentation index, see [llms.txt](https://docs.himodus.com/modus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.himodus.com/modus/gong-mcp-connection.md).

# Gong MCP Connection

## Gong MCP Connection Setup Guide

This guide walks you through connecting your Gong workspace to the Modus MCP server to access RevOps and sales performance data directly within Gong.

### Prerequisites

* Access to a Modus workspace
* Admin access to your Gong workspace

### Setup Steps

#### Step 1: Sign Up for Modus

1. Navigate to the [Modus Dashboard](https://app.himodus.com)
2. Sign up for a new account or log in to your existing workspace
3. Complete the onboarding process if this is your first time

#### Step 2: Create OAuth Credentials in Modus

1. In the Modus Dashboard, navigate to the **Developer** section
2. Click **Create New OAuth Application**
3. Fill in the application details:
   * **Application Name**: `Gong MCP Connection` (or your preferred name)
   * **Redirect Callback URL**: `https://app.gong.io/mcp-connections/authorization-complete`
   * **Scopes**: Select `mcp:read` and `mcp:write`
4. Click **Create Application**
5. **Save the credentials** that are generated:

   * **Client ID**
   * **Client Secret**

   ⚠️ **Important**: Store these credentials securely. The Client Secret will only be shown once.

#### Step 3: Configure MCP Connection in Gong

1. Log in to your Gong workspace
2. Navigate to **Admin Center** → **Settings** → **MCP Connections**
3. Click **Add New MCP Connection**
4. Enter the connection details:
   * **Name**: `Modus RevOps Data`
   * **MCP Server URL**: `https://mcp.himodus.com/mcp`
   * **Client ID**: *\[Your Client ID from Step 2]*
   * **Client Secret**: *\[Your Client Secret from Step 2]*
5. Click **Connect**

#### Step 4: Complete OAuth Authorization

1. You will be redirected to the Modus authorization page
2. Review the permissions requested
3. Click **Authorize** to grant Gong access to your Modus data
4. You will be redirected back to Gong

#### Step 5: Verify the Connection

1. In Gong's MCP Connections page, verify that your Modus connection shows as **Connected**
2. Test the connection by asking a question in Gong, such as:
   * "Show me our top sales performers this quarter"
   * "What's our current attrition rate?"

### Connection Details

* **MCP Server URL**: `https://mcp.himodus.com/mcp`
* **OAuth Authorization Server**: `https://api.himodus.com/.well-known/oauth-authorization-server`
* **Redirect URI**: `https://app.gong.io/mcp-connections/authorization-complete`
* **Required Scopes**: `mcp:read`, `mcp:write`

### Available Data

Once connected, you can access the following data from Modus:

* **Sales Performance**: Team performance, leaderboards, quota attainment
* **Workforce Analytics**: Headcount, attrition rates, hiring timelines
* **Employee Insights**: AI-driven insights on performance and risk
* **Capacity Planning**: Quarterly capacity and sales breakdowns
* **Financial Metrics**: Budget forecasts and compensation data
* **Gong Activity**: Call activity, engagement scores, and trends

### Example Prompts

Try these prompts in Gong after connecting:

* "Show me the top 5 sales performers this quarter"
* "What's our current attrition rate and which roles are at highest risk?"
* "Give me the hiring timeline for sales roles in 2025"
* "How is our team performing against quota this month?"
* "Show me employees with declining Gong call activity"
* "What's our quarterly capacity forecast for Q3?"
* "Which sales reps are at risk of churning based on activity signals?"

### Troubleshooting

#### Connection Failed

* Verify that your Client ID and Client Secret are correct
* Ensure the redirect URI is exactly: `https://app.gong.io/mcp-connections/authorization-complete`
* Check that your MCP server URL is: `https://mcp.himodus.com/mcp`

#### Authorization Error

* Make sure you have admin access in your Modus workspace
* Verify that the OAuth application is active in Modus
* Try disconnecting and reconnecting the MCP connection in Gong

#### Data Not Showing

* Confirm that your Modus workspace has data populated
* Check that you granted all required permissions during authorization
* Try refreshing the connection by disconnecting and reconnecting