> This page is for version v8.3.0 (default). > For other versions, use one of these documentation indexes: > - v8.3.0 (default): https://docs.workflows.com/v-8-3-0/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.workflows.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.workflows.com/_mcp/server. # gong_list_calls 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. > **Success** > > 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](/mcp-integrations-gong-setup) for configuration instructions. ## Parameters ### fromDate
**Type** string (ISO 8601 date)
**Required** No
**Description** Start date for filtering calls. Format: `YYYY-MM-DD` . If omitted, returns calls from the beginning of your account history.
**Example** `2024-01-01`
### toDate
**Type** string (ISO 8601 date)
**Required** No
**Description** End date for filtering calls. Format: `YYYY-MM-DD` . If omitted, returns calls up to the current date.
**Example** `2024-12-31`
### limit
**Type** number
**Required** No
**Description** Maximum number of calls to return. Default: 10. Maximum: 100.
**Example** `20`
## Request ```json { "fromDate": "2024-11-01", "toDate": "2024-11-30", "limit": 20 } ``` ## Response ```json { "calls": [ { "callId": "call_abc123", "title": "Discovery Call - Enterprise Prospect", "date": "2024-11-15T14:30:00Z", "duration": 3600, "participants": [ { "name": "Sarah Johnson", "email": "sarah.johnson@prospect.com", "role": "prospect" }, { "name": "Mike Chen", "email": "mike.chen@yourcompany.com", "role": "internal" } ] }, { "callId": "call_def456", "title": "Product Demo - Mid-Market Lead", "date": "2024-11-18T10:00:00Z", "duration": 2700, "participants": [ { "name": "Alex Martinez", "email": "alex@smallbiz.com", "role": "prospect" } ] } ], "total": 45, "hasMore": true } ``` ### Response Properties | Property | Type | Description | | ------------------------------ | ------- | ---------------------------------------------------------- | | `calls` | array | Array of call objects with metadata | | `calls[].callId` | string | Unique identifier for the call (use with other Gong tools) | | `calls[].title` | string | Call title or description from Gong | | `calls[].date` | string | ISO 8601 timestamp of when the call occurred | | `calls[].duration` | number | Call duration in seconds | | `calls[].participants` | array | Array of participant objects | | `calls[].participants[].name` | string | Participant's full name | | `calls[].participants[].email` | string | Participant's email address | | `calls[].participants[].role` | string | `"internal"` (your team) or `"prospect"` (external) | | `total` | number | Total number of calls matching the filter criteria | | `hasMore` | boolean | Whether 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 ```json { "error": "Unauthorized", "message": "Gong authentication failed" } ``` **Solution:** Verify your Gong Access Key and Access Key Secret are configured correctly. See the [Gong Setup Guide](/mcp-integrations-gong-setup). #### 400 Bad Request - Invalid Date ```json { "error": "Bad Request", "message": "Invalid date format. Use YYYY-MM-DD" } ``` **Solution:** Ensure dates are in ISO 8601 format: `YYYY-MM-DD` (e.g., `2024-11-15`). #### 429 Rate Limit Exceeded ```json { "error": "Rate Limit Exceeded", "message": "Too many requests to Gong API", "retryAfter": 60 } ``` **Solution:** Wait for the specified time (in seconds) before retrying. Reduce request frequency or use date filtering to narrow results. #### 404 No Calls Found ```json { "calls": [], "total": 0, "hasMore": false } ``` **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 #### List Calls Use `gong_list_calls` to discover available calls in your date range #### Select Calls Review participants and titles to identify calls for mind creation #### Get Transcripts Use `gong_get_transcript` with selected call IDs to retrieve full conversations #### 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](/mcp-tool-gong-get-transcript) Retrieve full transcripts after listing calls #### [gong_get_call_details](/mcp-tool-gong-get-call-details) Get analytics and topics for calls #### [Gong Integration Setup](/mcp-integrations-gong-setup) Configure Gong integration #### [Gong Tools Overview](/mcp-integrations-gong) See all Gong tools and workflows