gong_list_calls

List Gong call recordings with optional date filtering
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

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

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

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

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.

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).

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.

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
  • 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
  • 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