Gong CLI for AI Agents

Framework Integration Gradient
Gong Logo
CLI Logo
divider

Introduction

CLIs are eating MCPs. The industry is converging on the very same idea. MCPs for all their merit can be token hungry, slow, and unreliable for complex tool chaining. However, coding agents have become incredibly good at working with CLIs, and in fact they are far more comfortable working with CLI tools than MCP.

With Composio's Universal CLI, your coding agents can talk to over 850+ SaaS applications. With Gong, agents can create a new gong meeting with your team, list user activity statistics for last week, add call recording media to a specific call, and more — all without worrying about authentication.

This guide walks you through Composio Universal CLI and explains how you can connect it with coding agents like Claude Code, Codex, OpenCode, etc, for end-to-end Gong automation.

Also integrate Gong with

What is Universal CLI and why use it?

The idea behind building the universal CLI is to give agents a single command interface to interact with all your external applications. Here's what you'll get with it:

  • Agent-friendly: Coding agents like Claude Code, Codex, and OpenCode can use CLI tools natively — no MCP setup required.
  • Authentication handled: Connect once via OAuth or API Key, and all CLI commands work with your credentials automatically.
  • Tool discovery: Search, inspect, and execute 20,000+ tools across 850+ apps from one interface.
  • Trigger support: Use triggers to listen for events across your apps, powered by real-time webhooks or polling under the hood.
  • Type generation: Generate typed schemas for autocomplete and type safety in your projects.

Prerequisites

Install the Composio CLI, authenticate, and initialize your project:

bash
# Install the Composio CLI
curl -fsSL https://composio.dev/install | bash

# Authenticate with Composio
composio login

During login you'll be redirected to sign in page, finish the complete flow and you're all set.

Composio CLI authentication flow

Connecting Gong to Coding Agents via Universal CLI

Once it is installed, it's essentially done. Claude Code, Codex, OpenCode, OpenClaw, or any other agent will be able to access the CLI. A few steps to give agents access to your apps.

  1. Launch your Coding Agent — Claude Code, Codex, OpenCode, anything you prefer.
  2. Prompt it to "Authenticate with Gong"
  3. Complete the authentication and authorization flow and your Gong integration is all set.
  4. Start asking anything you want.

Supported Tools & Triggers

Tools
Add call media v2 calls id mediaAdds a call media, recorded by a telephony system (PBX) or other media recording facility.
Add new call v2 callsWhen using this endpoint, either provide a downloadMediaUrl or use the returned callId in a follow-up request to /v2/calls/{id}/media to upload the media file.
Aggregate activity by period via apiLists the aggregated activity of multiple users within the Gong system for each time period within the defined date range.
Aggregate user activity statisticsLists the activity of multiple users within the Gong system during a defined period.
Assign prospects to flowUse this endpoint to assign a number of prospects to a flow.
Create activity scorecards reportRetrieve all the answers for the scorecards that were reviewed during a specified date range, for calls that took place during a specified date range, for specific scorecards or for specific reviewed users.
Create a new gong meeting v2 meetingsWhen accessed through a Bearer token authorization method, this endpoint requires the scope 'api:meetings:user:create'.
Create permission profile v2 permission profileCreate a permission profile in a given workspace.
Data privacy for phone numberShows the elements in the Gong system that reference the given phone number.
Delete a generic crm integration v2 crm integrationsDeletes an existing CRM integration from the Gong platform.
Delete a gong meeting v2 meetingsWhen accessed through a Bearer token authorization method, this endpoint requires the scope 'api:meetings:user:delete'.
Delete users from call access listRemove individual user access from calls.
Erase data for email addressGiven an email address, this endpoint deletes from the Gong system any calls or email messages that reference this address.
Erase data for phone numberGiven a phone number, this endpoint deletes from the Gong system any leads or contacts with a matching phone number or mobile phone number.
Fetch all permission profilesReturns a list of all permission profiles.
Get Crm Integration Details.
Get crm objects v2 crm entitiesRetrieves CRM entities from the Gong platform.
Get permission profileReturns a permission profile.
Get request status v2 crm request statusThe GetCRMRequestStatus endpoint retrieves the current status of CRM integration requests in the Gong platform.
List all coaching metrics v2 coachingList all of the coaching metrics of a manager.
List all company workspaces v2 workspacesReturns a list of all workspaces including their details.
List all users v2 usersList all of the company's users.
List flows for crm prospectsGet the Gong Engage flows assigned to the given prospects.
List Folder CallsGiven a folder id, this endpoint retrieves a list of calls in it.
List gong engage flows v2 flowsEngage flows have the following visibility types: * Company: visible to everyone in the company, can only be edited by users with edit permissions.
List schema fields v2 crm entity schemaRetrieves the comprehensive schema of CRM entities in the Gong platform.
List users by filter v2 users extensiveList multiple Users.
Manage user call accessReturns a list of users who have received individual access to calls through the API.
Post a digital interaction v2 digital interactionWhen accessed through a Bearer token authorization method, this endpoint requires the scope 'api:digital-interactions:write'.
Post day by day activity statsRetrieve the daily activity of multiple users within the Gong system for a range of dates.
Post interaction filter statsReturns interaction stats for users based on calls that have Whisper turned on.
Post meeting integration statusWhen accessed through a Bearer token authorization method, this endpoint requires the scope 'api:meetings:integration:status'.
Register Crm IntegrationUpdates an existing CRM integration in the Gong platform.
Report content viewed eventPush engagement events into Gong and display them as events in Gong’s activity timeline, when a content is viewed by an external participant (for example, a contract was “viewed” by the prospect) When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:engagement-data:write'.
Report Custom Engagement EventPush engagement events into Gong and display them as events in Gong’s activity timeline, when a content is engaged by an external participant (for example, a contract was “signed” by the prospect) When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:engagement-data:write'.
Retrieve call data by date range v2 callsList calls that took place during a specified date range.
Retrieve data for a specific call v2 calls idRetrieve data for a specific call.
Retrieve data privacy info for email addressShows the elements in the Gong system that reference the given email address.
Retrieve filtered call detailsLists detailed call data for calls that took place during a specified date range, have specified call IDs or hosted by specified users.
Retrieve library folders v2 library foldersUse this endpoint to retrieve a list of public library folders.
Retrieve logs data by type and time range v2 logsList log entries that took place during a specified time range.
Retrieve manual crm call associationsReturns a list of all calls that were manually associated or re-associated with CRM account and deal/opportunity since a given time.
Retrieve scorecards details v2 settings scorecardsRetrieve all the scorecards within the Gong system.
Retrieve tracker details v2 settings trackersRetrieves details of all keyword trackers in the system or in a given workspace.
Retrieve transcripts of calls v2 calls transcriptReturns transcripts for calls that took place during the specified date period.
Retrieve User Settings HistoryRetrieve a specific user's settings history.
Retrieve users from permission profileReturns a list of all users whose access is controlled by the given permission profile.
Retrieve user v2 users idRetrieve a specific user.
Set User Call AccessGive individual users access to calls.
Update a gong meeting v2 meetings meetingidWhen accessed through a Bearer token authorization method, this endpoint requires the scope 'api:meetings:user:update'.
Update permission profile v2 permission profileUpdate a permission profile.
Update shared content eventPush engagement events into Gong and display them as events in Gong’s activity timeline, when a Gong user shares content with external participants (for example, a contract was “shared” by the account executive with his prospects) When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:engagement-data:write'.
Upload crm objects v2 crm entitiesUploads CRM data files to the Gong platform for integration and analysis.

Universal CLI Commands for Gong

You can also manually execute CLI commands to interact with your Gong.

Connect your Gong account

Link your Gong account and verify the connection:

bash
# Connect your Gong account (opens OAuth flow)
composio connected-accounts link gong

# Verify the connection
composio connected-accounts list --toolkits gong

Discover Gong tools

Search and inspect available Gong tools:

bash
# List all available Gong tools
composio tools list --toolkit gong

# Search for Gong tools by action
composio tools search "gong"

# Inspect a tool's input schema
composio tools info GONG_ADD_CALL_MEDIA_V2_CALLS_ID_MEDIA

Common Gong Actions

Add call media v2 calls id mediaAdds a call media, recorded by a telephony system (pbx) or other media recording facility

bash
composio tools execute GONG_ADD_CALL_MEDIA_V2_CALLS_ID_MEDIA \
  --id "<string>"

Add new call v2 callsWhen using this endpoint, either provide a downloadmediaurl or use the returned callid in a follow-up request to /v2/calls/{id}/media to upload the media file

bash
composio tools execute GONG_ADD_NEW_CALL_V2_CALLS \
  --parties "<array>" \
  --direction "<string>" \
  --actualStart "<string>" \
  --clientUniqueId "<string>"

Aggregate activity by period via apiLists the aggregated activity of multiple users within the gong system for each time period within the defined date range

bash
composio tools execute GONG_AGGREGATE_ACTIVITY_BY_PERIOD_VIA_API \
  --aggregationPeriod "<string>"

Aggregate user activity statisticsLists the activity of multiple users within the gong system during a defined period

bash
composio tools execute GONG_AGGREGATE_USER_ACTIVITY_STATISTICS \
  --cursor "<string>" \
  --filter__toDate "<string>" \
  --filter__userIds "<array>" \
  --filter__fromDate "<string>"

Generate Type Definitions

Generate typed schemas for Gong tools to get autocomplete and type safety in your project:

bash
# Auto-detect language
composio generate --toolkits gong

# TypeScript
composio ts generate --toolkits gong

# Python
composio py generate --toolkits gong

Tips & Tricks

  • Always inspect a tool's input schema before executing: composio tools info <TOOL_NAME>
  • Pipe output with jq for better readability: composio tools execute TOOL_NAME -d '{}' | jq
  • Set COMPOSIO_API_KEY as an environment variable for CI/CD pipelines
  • Use composio dev logs tools to inspect execution logs and debug issues

Next Steps

  • Try asking your coding agent to perform various Gong operations
  • Explore cross-app workflows by connecting more toolkits
  • Set up triggers for real-time automation
  • Use composio generate for typed schemas in your projects

How to build Gong MCP Agent with another framework

FAQ

What is the Composio Universal CLI?

The Composio Universal CLI is a single command-line interface that lets coding agents and developers interact with 850+ SaaS applications. It handles authentication, tool discovery, action execution, and trigger setup — all from the terminal, without needing to configure MCP servers.

Which coding agents work with the Composio CLI?

Any coding agent that can run shell commands works with the Composio CLI — including Claude Code, Codex, OpenCode, OpenClaw, and others. Once the CLI is installed, agents automatically discover and use the composio commands to interact with Gong and other connected apps.

How is the CLI different from using an MCP server for Gong?

MCP servers require configuration and can be token-heavy for complex workflows. The CLI gives agents a direct, lightweight interface — no server setup needed. Agents simply call composio commands like any other shell tool. It's faster to set up, more reliable for multi-step tool chaining, and works natively with how coding agents already operate.

How safe is my Gong data when using the Composio CLI?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Gong data and credentials are handled as safely as possible. You can also bring your own OAuth credentials for full control.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.