For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Workflows
    • Overview
  • Get Started
    • MCP Quick Start
    • API Quick Start
  • MCP Server
    • Overview
    • Installation
      • Overview
      • get_all_minds
      • search_minds
      • create_mind
      • get_signed_upload_url
      • upload_file_to_signed_url
      • create_snapshot
      • get_snapshot_status
      • simulate
      • gong_list_calls
      • gong_get_transcript
      • gong_get_call_details
      • fathom_list_meetings
      • fathom_get_transcript
      • fathom_get_meeting_details
      • fireflies_list_transcripts
      • fireflies_get_transcript
      • fireflies_search_transcripts
  • Direct API
    • Overview
    • Authentication
    • Error Handling
  • Core Concepts
    • Minds, Snapshots, & Simulations
    • SOC 2, HIPAA, & GDPR
LogoLogo
LogoLogo
On this page
  • Prerequisites
  • Parameters
  • fromDate
  • toDate
  • limit
  • Request
  • Response
  • Response Properties
  • Common Use Cases
  • Error Responses
  • Best Practices
  • Integration with Mind Reasoner
  • Typical Workflow
  • See Also
MCP ServerTools Reference

gong_list_calls

List Gong call recordings with optional date filtering
Was this page helpful?
Previous

gong_get_transcript

Retrieve detailed transcripts from Gong calls with speaker attribution
Next
Built with
READ

gong_list_calls

Retrieves a list of call recordings from your Gong account with optional date filtering. Use this tool to discover available calls before retrieving transcripts or creating minds.

This tool provides quick access to your Gong call library. Filter by date range to find specific calls, then use the returned call IDs to retrieve transcripts or call details.

Prerequisites

Gong Integration Required

This tool requires Gong integration to be configured. See the Gong Setup Guide for configuration instructions.

Parameters

fromDate

Typestring (ISO 8601 date)
RequiredNo
DescriptionStart date for filtering calls. Format: YYYY-MM-DD. If omitted, returns calls from the beginning of your account history.
Example2024-01-01

toDate

Typestring (ISO 8601 date)
RequiredNo
DescriptionEnd date for filtering calls. Format: YYYY-MM-DD. If omitted, returns calls up to the current date.
Example2024-12-31

limit

Typenumber
RequiredNo
DescriptionMaximum number of calls to return. Default: 10. Maximum: 100.
Example20

Request

1{
2 "fromDate": "2024-11-01",
3 "toDate": "2024-11-30",
4 "limit": 20
5}

Response

1{
2 "calls": [
3 {
4 "callId": "call_abc123",
5 "title": "Discovery Call - Enterprise Prospect",
6 "date": "2024-11-15T14:30:00Z",
7 "duration": 3600,
8 "participants": [
9 {
10 "name": "Sarah Johnson",
11 "email": "sarah.johnson@prospect.com",
12 "role": "prospect"
13 },
14 {
15 "name": "Mike Chen",
16 "email": "mike.chen@yourcompany.com",
17 "role": "internal"
18 }
19 ]
20 },
21 {
22 "callId": "call_def456",
23 "title": "Product Demo - Mid-Market Lead",
24 "date": "2024-11-18T10:00:00Z",
25 "duration": 2700,
26 "participants": [
27 {
28 "name": "Alex Martinez",
29 "email": "alex@smallbiz.com",
30 "role": "prospect"
31 }
32 ]
33 }
34 ],
35 "total": 45,
36 "hasMore": true
37}

Response Properties

PropertyTypeDescription
callsarrayArray of call objects with metadata
calls[].callIdstringUnique identifier for the call (use with other Gong tools)
calls[].titlestringCall title or description from Gong
calls[].datestringISO 8601 timestamp of when the call occurred
calls[].durationnumberCall duration in seconds
calls[].participantsarrayArray of participant objects
calls[].participants[].namestringParticipant’s full name
calls[].participants[].emailstringParticipant’s email address
calls[].participants[].rolestring"internal" (your team) or "prospect" (external)
totalnumberTotal number of calls matching the filter criteria
hasMorebooleanWhether there are more calls beyond the limit

Common Use Cases

Find Recent Calls

Discover calls from a specific time period to create minds or analyze conversations.

Example:

"Show me all my Gong calls from the last week"

Natural language workflow:

  • AI uses gong_list_calls with date filter for last 7 days
  • Returns list of recent calls with participants
  • You can then select specific calls for transcript retrieval

What you get:

  • Call IDs for transcript retrieval
  • Participant information
  • Call durations and dates
  • Quick overview of recent activity
Discovery Before Mind Creation

Find calls with specific people before creating minds from their conversations.

Example:

"Find all my Gong calls with enterprise prospects from Q4"

Natural language workflow:

  • AI lists calls from Q4
  • Filters to those with external participants
  • Identifies enterprise prospects based on context
  • Provides call list for selection

What you get:

  • List of relevant calls
  • Participant details for each call
  • Ability to select which calls to use for mind creation
Call Inventory & Analysis

Build an inventory of calls for reporting or analysis purposes.

Example:

"List all my calls from this month and show me how many
were discovery vs. demo vs. closing calls"

Natural language workflow:

  • AI lists all calls from current month
  • Analyzes titles to categorize call types
  • Provides breakdown and statistics

What you get:

  • Complete call inventory
  • Call categorization
  • Participant trends
  • Activity patterns

Error Responses

401 Unauthorized
1{
2 "error": "Unauthorized",
3 "message": "Gong authentication failed"
4}

Solution: Verify your Gong Access Key and Access Key Secret are configured correctly. See the Gong Setup Guide.

400 Bad Request - Invalid Date
1{
2 "error": "Bad Request",
3 "message": "Invalid date format. Use YYYY-MM-DD"
4}

Solution: Ensure dates are in ISO 8601 format: YYYY-MM-DD (e.g., 2024-11-15).

429 Rate Limit Exceeded
1{
2 "error": "Rate Limit Exceeded",
3 "message": "Too many requests to Gong API",
4 "retryAfter": 60
5}

Solution: Wait for the specified time (in seconds) before retrying. Reduce request frequency or use date filtering to narrow results.

404 No Calls Found
1{
2 "calls": [],
3 "total": 0,
4 "hasMore": false
5}

Solution: This is not an error—it means no calls match your filter criteria. Try:

  • Widening the date range
  • Removing date filters entirely
  • Verifying your Gong account has recorded calls
  • Checking your user permissions in Gong

Best Practices

Use Date Filters
  • Start with narrow date ranges to reduce result sets
  • Use recent dates (last week, last month) for quicker responses
  • Widen date ranges only when searching for older calls
  • Remember Gong API rate limits apply to result size
Pagination Strategy
  • Use limit to control result size
  • Check hasMore to see if additional calls exist
  • For large call libraries, filter by date rather than paginating
  • Save call IDs for later retrieval rather than re-listing
Efficient Discovery
  • List calls first, then retrieve transcripts only for selected calls
  • Use participant info to pre-filter before transcript retrieval
  • Check call duration to prioritize longer, more substantive calls
  • Review call titles to identify relevant conversations

Integration with Mind Reasoner

Typical Workflow

1

List Calls

Use gong_list_calls to discover available calls in your date range

2

Select Calls

Review participants and titles to identify calls for mind creation

3

Get Transcripts

Use gong_get_transcript with selected call IDs to retrieve full conversations

4

Create Minds

Use Mind Reasoner tools to create minds from the transcripts

Natural language example:

"Find my Gong calls with C-level executives from last quarter,
then create minds for each executive based on our conversations"

AI orchestrates the entire workflow automatically.

See Also

gong_get_transcript

Retrieve full transcripts after listing calls

gong_get_call_details

Get analytics and topics for calls

Gong Integration Setup

Configure Gong integration

Gong Tools Overview

See all Gong tools and workflows