Gong Automation

---
name: Gong Automation
description: Automate Gong conversation intelligence -- retrieve call recordings, transcripts, detailed analytics, speaker stats, and workspace data -- using natural language through the Composio MCP integration. 
category: Development & Code Tools
source: composio
tags: [api, git, cli, mcp, automation, ai]
url: https://github.com/ComposioHQ/awesome-claude-skills/tree/master/gong-automation
---


# Gong Automation

Unlock insights from your sales calls -- retrieve transcripts, analyze call data by date range, access detailed conversation analytics with topics and trackers, and manage workspaces -- all through natural language commands.

**Toolkit docs:** [composio.dev/toolkits/gong](https://composio.dev/toolkits/gong)

---

## Setup

1. Add the Composio MCP server to your client configuration:
   ```
   https://rube.app/mcp
   ```
2. Connect your Gong account when prompted (OAuth / Bearer token authentication).
3. Start issuing natural language commands to analyze your call data.

---

## Core Workflows

### 1. Retrieve Call Transcripts by Date Range
Get transcripts for all calls within a specified time period, with optional filtering by specific call IDs or workspace.

**Tool:** `GONG_RETRIEVE_TRANSCRIPTS_OF_CALLS_V2_CALLS_TRANSCRIPT`

**Example prompt:**
> "Get Gong transcripts for all calls from February 1-10, 2025"

**Key parameters:**
- `filter__fromDateTime` -- ISO-8601 start date (e.g., `2025-02-01T00:00:00Z`)
- `filter__toDateTime` -- ISO-8601 end date (e.g., `2025-02-10T23:59:59Z`)
- `filter__callIds` -- Optional array of specific call IDs to filter
- `filter__workspaceId` -- Optional workspace ID filter
- `cursor` -- Pagination cursor from previous response

**Required scope:** `api:calls:read:transcript`

---

### 2. Get Transcript for Specific Calls
Retrieve transcripts with speaker information, timestamps, and topic categorization using a filter object.

**Tool:** `GONG_GET_CALL_TRANSCRIPT`

**Example prompt:**
> "Get the Gong transcript for call ID 555785916001072125"

**Key parameters (filter required):**
- `filter.callIds` -- Array of specific call IDs (e.g., `["555785916001072125"]`)
- `filter.fromDateTime` -- ISO-8601 start date
- `filter.toDateTime` -- ISO-8601 end date
- `filter.workspaceId` -- Optional workspace filter
- `cursor` -- Pagination cursor

---

### 3. List Calls by Date Range
Retrieve basic call metadata (participants, duration, timing) for calls within a date range.

**Tool:** `GONG_RETRIEVE_CALL_DATA_BY_DATE_RANGE_V2_CALLS`

**Example prompt:**
> "List all Gong calls from last week"

**Key parameters (both required):**
- `fromDateTime` -- ISO-8601 start date (e.g., `2025-02-03T00:00:00Z`)
- `toDateTime` -- ISO-8601 end date (e.g., `2025-02-10T00:00:00Z`)
- `workspaceId` -- Optional workspace filter
- `cursor` -- Pagination cursor

**Required scope:** `api:calls:read:basic`

---

### 4. Get Detailed Call Analytics
Retrieve extensive call details including highlights, key points, topics, trackers, speaker stats, questions, and media URLs.

**Tool:** `GONG_RETRIEVE_FILTERED_CALL_DETAILS`

**Example prompt:**
> "Get detailed analytics for Gong calls this week including topics, key points, and speaker stats"

**Key parameters:**
- `filter__fromDateTime` / `filter__toDateTime` -- Date range filter
- `filter__callIds` -- Specific call IDs
- `filter__primaryUserIds` -- Filter by call host user IDs
- Content selectors (all boolean):
  - `contentSelector__exposedFields__content__keyPoints` -- Key points of the call
  - `contentSelector__exposedFields__content__topics` -- Topic durations
  - `contentSelector__exposedFields__content__highlights` -- Call highlights
  - `contentSelector__exposedFields__content__outline` -- Call outline
  - `contentSelector__exposedFields__content__brief` -- Spotlight call brief
  - `contentSelector__exposedFields__content__callOutcome` -- Call outcome
  - `contentSelector__exposedFields__content__trackers` -- Smart/keyword trackers
  - `contentSelector__exposedFields__content__trackerOccurrences` -- Tracker timing and speaker (requires trackers=true)
  - `contentSelector__exposedFields__interaction__speakers` -- Time each participant spoke
  - `contentSelector__exposedFields__interaction__questions` -- Question counts
  - `contentSelector__exposedFields__interaction__personInteractionStats` -- Host statistics
  - `contentSelector__exposedFields__media` -- Audio/video URLs (valid 8 hours)
  - `contentSelector__exposedFields__parties` -- Party information
  - `contentSelector__exposedFields__collaboration__publicComments` -- Public comments
- `contentSelector__context` -- "Basic", "Extended", or "None" for CRM/external system links

**Required scope:** `api:calls:read:extensive` (plus `api:calls:read:media-url` for media)

---

### 5. Get a Specific Call by ID
Retrieve basic data for a single call using its unique Gong ID.

**Tool:** `GONG_RETRIEVE_DATA_FOR_A_SPECIFIC_CALL_V2_CALLS_ID`

**Example prompt:**
> "Get details for Gong call 1223781272986876929"

**Key parameters (required):**
- `id` -- Gong's unique numeric identifier for the call (up to 20 digits)

**Required scope:** `api:calls:read:basic`

---

### 6. List Company Workspaces
Retrieve all workspaces in your Gong organization to get workspace IDs for filtering.

**Tool:** `GONG_LIST_ALL_COMPANY_WORKSPACES_V2_WORKSPACES`

**Example prompt:**
> "List all Gong workspaces in my company"