＋ Add to collection

Install (CLI)

npx skillmds add composiohq/gong-automation

Or Copy and Paste in Your Agent chat

Please install the Agent Skill "composiohq/gong-automation" for me from skillmd.com. A SkillMD skill is a SKILL.md file — plain markdown — that you save into my skills directory. Use whichever fetch route fits your setup: (1) if you have a terminal, run npx -y skillmds add composiohq/gong-automation; (2) otherwise fetch https://api.skillmd.com/api/skills/composiohq/gong-automation/raw (served as text/markdown) and save it as gong-automation/SKILL.md in your skills directory; (3) if the SkillMD MCP tools are connected, call skillmd_download with slug "composiohq/gong-automation" and save the returned files under gong-automation/. Show me the SKILL.md before saving if you'd like me to review it. If your skills directory is read-only (e.g. the Claude desktop app), save the files to a working folder instead and tell me — I'll add them through my app's skills settings.

README badge

Show this skill's registry status in your repo:

[![SkillMD](https://skillmd.com/badge/composiohq/gong-automation.svg)](https://skillmd.com/skills/composiohq/gong-automation)

Gong Automation

Name: Gong Automation
Rating: 4.2 (5 reviews)
Author: Composio HQ

composiohq/gong-automation · Agent Skill

by Composio HQ · single

Published Jul 5, 2026 · Last updated Jul 6, 2026

Retrieve call transcripts, analytics, speaker stats, and workspace data from Gong conversation intelligence using natural language commands.

SKILL.md

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

Setup

Add the Composio MCP server to your client configuration:
```
https://rube.app/mcp
```
Connect your Gong account when prompted (OAuth / Bearer token authentication).
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

---
name: gong-automation
description: Retrieve call transcripts, analytics, speaker stats, and workspace data from Gong conversation intelligence using natural language commands.
---

# 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)*

ComposioHQ/awesome-claude-skills/tree/master/composio-skills/gong-automation commit · 92568c1eda

▌
gong · johnalbertini14-glitch bundle
Search and retrieve Gong call recordings, transcripts, user lists, and activity statistics via the Gong API.

1
repo stars
▌
gong · demerzels-lab bundle
Search and retrieve Gong call recordings, transcripts, users, and activity stats via the Gong API.

10
repo stars
▌
keen-io-automation · composiohq
Automate Keen IO analytics operations through Composio's Rube MCP integration, with dynamic tool discovery and connection management.

66.9k
repo stars
▌
simple-analytics-automation · composiohq
Automate Simple Analytics operations through Composio's Simple Analytics toolkit via Rube MCP.

66.9k
repo stars
▌
rosette-text-analytics-automation · composiohq
Automates Rosette Text Analytics operations through Composio's toolkit via Rube MCP, including tool discovery, connection management, and execution.

66.9k
repo stars
▌
gong · kbarbel640-del bundle
Query Gong conversation intelligence APIs to list calls, fetch transcripts, manage users, and retrieve activity stats.

1
repo stars

Frequently asked questions

How do I install the Gong Automation skill?

Run npx skillmds add composiohq/gong-automation in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Gong Automation skill do?

Retrieve call transcripts, analytics, speaker stats, and workspace data from Gong conversation intelligence using natural language commands. It is listed under Data & Analytics, Integrations & APIs, Data Analysis, SaaS Connectors on SkillMD.

Is Gong Automation safe to use?

SkillMD's automated safety review verdict for this skill is CAUTION. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gong Automation?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gong Automation free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gong Automation?

Composio HQ (@composiohq) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gong Automation

Gong Automation

Setup

Core Workflows

1. Retrieve Call Transcripts by Date Range

2. Get Transcript for Specific Calls

3. List Calls by Date Range

4. Get Detailed Call Analytics

5. Get a Specific Call by ID

6. List Company Workspaces

Known Pitfalls

Quick Reference

Related

Frequently asked questions