Skip to main content
Agent skill

Gong Automation

Automate Gong conversation intelligence -- retrieve call recordings, transcripts, detailed analytics, speaker stats, and workspace data -- using natural language through the Composio MCP integration.

Get started

Get the complete skill folder, including its scripts and reference files.

This workflow depends on an external MCP integration. Check the source for the server, account access and setup it requires.

When to use this skill

Use Gong Automation when an AI agent needs a reusable SKILL.md workflow for this job: Automate Gong conversation intelligence -- retrieve call recordings, transcripts, detailed analytics, speaker stats, and workspace data -- using natural language through the Composio MCP integration.

When not to use it

Skip Gong Automation when the task is outside the analysis category, or when a more specific skill in this directory already covers the same workflow with clearer triggers.

How to install

Where will you use it?

Install scope
Claude Code folder setup
mkdir -p ~/.claude/skills/gong-automation
# Save SKILL.md to ~/.claude/skills/gong-automation/SKILL.md
  1. Claude Code personal install: place the skill and its bundled files at ~/.claude/skills/gong-automation/SKILL.md. For a shared project, commit the folder at .claude/skills/gong-automation/ instead.
  2. Current Claude Code detects SKILL.md changes in watched directories during the session. If you just created a top-level skills directory, run /reload-skills. Check that the skill is listed before testing its trigger.
  3. For Claude chat or Cowork in the Desktop app, manage uploaded skills in Customize > Skills; copying files into a local Claude Code folder is not a Desktop install. Other agents may use different install locations.

Full install guide for Claude, Cursor, and Codex →

Try a starter prompt

After installing the skill, paste this starter prompt into your agent to verify it triggers on a small task.

Starter prompt
Use the Gong Automation skill for this task: Use Gong Automation when this documented workflow matches the task. Confirm any required inputs or files before making changes.

What supports this recommendation?

63/100 provisional content score. This measures documentation, practical detail and source signals. It is not a measured task success rate or a security certification.

Documentation
67/100
Practical detail
50/100
Source evidence
63/100
Source signals
80/100
Model compatibility evidence
  • claudeinferred

    The skill text mentions Claude or a closely associated term. This is keyword-derived compatibility; no hands-on model test is recorded.

  • chatgptuntested

    No model-specific signal or recorded compatibility test was found.

  • geminiuntested

    No model-specific signal or recorded compatibility test was found.

  • copilotuntested

    No model-specific signal or recorded compatibility test was found.

  • llamauntested

    No model-specific signal or recorded compatibility test was found.

  • perplexityuntested

    No model-specific signal or recorded compatibility test was found.

  • mistraluntested

    No model-specific signal or recorded compatibility test was found.

  • grokuntested

    No model-specific signal or recorded compatibility test was found.

Inferred compatibility is based on content signals. Check the app, its available tools and setup requirements before running a skill.

What this skill does

# 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"

**Key parameters:** None required.

**Required scope:** `api:workspaces:read`

---

## Known Pitfalls

- **ISO-8601 date format is mandatory**: All date parameters must use ISO-8601 format with timezone: `2025-02-01T00:00:00Z` or `2025-02-01T02:30:00-07:00`. Plain dates will fail. - **Date range is exclusive on toDateTime**: The `toDateTime` parameter returns calls started UP TO BUT EXCLUDING the specified time. To include calls on a specific day, set `toDateTime` to the next day. - **Pagination is required for large result sets**: All list endpoints return paginated results. Use the `cursor` value from the previous response to fetch the next page. Continue until no cursor is returned. - **Scope requirements vary by endpoint**: Different endpoints require different API scopes. Transcript access needs `api:calls:read:transcript`, basic call data needs `api:calls:read:basic`, and detailed analytics need `api:calls:read:extensive`. - **Media URLs expire after 8 hours**: Audio and video URLs returned by the detailed call endpoint are temporary and expire after 8 hours. - **Tracker occurrence data availability**: Tracker occurrence data (timing and speaker ID) is only available for calls recorded since January 1, 2023. Contact Gong support for backfill. - **Web-conference vs. regular calls**: For web-conference calls recorded by Gong, the date represents the scheduled time. For other calls, it represents the actual start time.

---

## Quick Reference

| Action | Tool Slug | Required Params | |---|---|---| | Get transcripts by date | `GONG_RETRIEVE_TRANSCRIPTS_OF_CALLS_V2_CALLS_TRANSCRIPT` | None (date range recommended) | | Get call transcript | `GONG_GET_CALL_TRANSCRIPT` | `filter` object | | List calls by date | `GONG_RETRIEVE_CALL_DATA_BY_DATE_RANGE_V2_CALLS` | `fromDateTime`, `toDateTime` | | Get detailed call analytics | `GONG_RETRIEVE_FILTERED_CALL_DETAILS` | None (date range or call IDs recommended) | | Get specific call | `GONG_RETRIEVE_DATA_FOR_A_SPECIFIC_CALL_V2_CALLS_ID` | `id` | | List workspaces | `GONG_LIST_ALL_COMPANY_WORKSPACES_V2_WORKSPACES` | None |

---

*Powered by [Composio](https://composio.dev)*

Intended uses

  • Use Gong Automation when this documented workflow matches the task.

Implementation notes

  • Review the source instructions and adapt inputs before running the workflow.

Try it, then tell us how it went

A copied prompt does not tell us whether the task worked. Report your result after checking the output. We collect your tool and outcome, never your files or prompt.