> 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. # fireflies_list_transcripts READ # fireflies_list_transcripts Retrieves a list of meeting transcripts from your Fireflies account with optional date filtering. Use this tool to discover available transcripts before retrieval or search. > **Success** > > List transcripts by date range to find specific meetings, then use the returned transcript IDs to retrieve full conversations or search for specific topics. ## Prerequisites > **Fireflies Integration Required** > > This tool requires Fireflies integration to be configured. See the [Fireflies Setup Guide](/mcp-integrations-fireflies-setup) for configuration instructions. > **Speaker Email Limitation** > > Fireflies does not directly provide speaker email addresses. Emails are inferred by correlating speaker names with meeting attendee emails via name matching. For guaranteed accurate speaker emails, use Gong or Fathom. ## Parameters ### fromDate
**Type** string (ISO 8601 date)
**Required** No
**Description** Start date for filtering transcripts. Format: `YYYY-MM-DD` . If omitted, returns transcripts from the beginning of your account history.
**Example** `2024-11-01`
### toDate
**Type** string (ISO 8601 date)
**Required** No
**Description** End date for filtering transcripts. Format: `YYYY-MM-DD` . If omitted, returns transcripts up to the current date.
**Example** `2024-11-30`
### limit
**Type** number
**Required** No
**Description** Maximum number of transcripts to return. Default: 10. Maximum: 100.
**Example** `20`
## Request ```json { "fromDate": "2024-11-01", "toDate": "2024-11-30", "limit": 20 } ``` ## Response ```json { "transcripts": [ { "transcriptId": "transcript_abc123", "title": "Weekly Team Standup", "date": "2024-11-15T10:00:00Z", "duration": 1800, "participants": [ { "name": "Sarah Chen" }, { "name": "Mike Johnson" }, { "name": "Alex Rivera" } ] }, { "transcriptId": "transcript_def456", "title": "Client Onboarding Call", "date": "2024-11-18T14:00:00Z", "duration": 2700, "participants": [ { "name": "Jennifer Wu" }, { "name": "Tom Davis" } ] } ], "total": 38, "hasMore": true } ``` ### Response Properties | Property | Type | Description | | ----------------------------------- | ------- | --------------------------------------------------------------------- | | `transcripts` | array | Array of transcript objects with metadata | | `transcripts[].transcriptId` | string | Unique identifier for the transcript (use with other Fireflies tools) | | `transcripts[].title` | string | Meeting title from calendar | | `transcripts[].date` | string | ISO 8601 timestamp of when the meeting occurred | | `transcripts[].duration` | number | Meeting duration in seconds | | `transcripts[].participants` | array | Array of participant objects | | `transcripts[].participants[].name` | string | Participant's name (email not available in list view) | | `total` | number | Total number of transcripts matching the filter criteria | | `hasMore` | boolean | Whether there are more transcripts beyond the limit | ## Common Use Cases #### Find Recent Meetings Discover meetings from a specific time period. **Example:** ``` "Show me all my Fireflies transcripts from the last two weeks" ``` **Natural language workflow:** * AI uses `fireflies_list_transcripts` with date filter for last 14 days * Returns list of recent meetings with participants * You can then select specific meetings for transcript retrieval **What you get:** * Meeting IDs for transcript retrieval * Participant names * Meeting dates and durations * Quick overview of recent activity #### Meeting Discovery Browse available meetings before searching or retrieving transcripts. **Example:** ``` "List all my Fireflies meetings from Q4" ``` **Natural language workflow:** * AI lists all meetings from October-December * Shows titles and participants * Provides transcript IDs for further action **What you get:** * Complete meeting inventory * Date-based filtering * Participant visibility * Foundation for search or retrieval #### Pre-Search Filtering List meetings from a timeframe before running keyword searches. **Example:** ``` "Show me my client meetings from last month, then search them for discussions about pricing" ``` **Natural language workflow:** * Lists meetings from last month * Filters to client meetings based on titles/participants * Searches filtered set for "pricing" keyword **What you get:** * Targeted search scope * Efficient API usage * Relevant results * Time-boxed analysis ## Error Responses #### 401 Unauthorized ```json { "error": "Unauthorized", "message": "Fireflies authentication failed" } ``` **Solution:** Verify your Fireflies API key is configured correctly. See the [Fireflies Setup Guide](/mcp-integrations-fireflies-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`. #### 429 Rate Limit Exceeded ```json { "error": "Rate Limit Exceeded", "message": "Too many requests to Fireflies API" } ``` **Solution:** Wait before retrying. Reduce request frequency or use date filtering. #### No Transcripts Found ```json { "transcripts": [], "total": 0, "hasMore": false } ``` **Solution:** Not an error—no transcripts match your criteria. Try: * Widening the date range * Removing date filters * Verifying transcripts exist in Fireflies * Checking account permissions ## Best Practices #### Use Date Filters * Start with narrow date ranges for faster responses * Use recent dates (last week/month) for quicker results * Widen ranges only when searching for older meetings * Remember API rate limits apply to result size #### Efficient Discovery * List transcripts first, then retrieve selectively * Use participant names to pre-filter * Check meeting duration to prioritize substantive meetings * Review titles to identify relevant conversations #### Combine with Search * Use listing for date-based filtering * Use search for topic-based filtering * Combine both for precise discovery * Save transcript IDs for later retrieval ## Integration with Mind Reasoner ### Typical Workflow #### List Transcripts Use `fireflies_list_transcripts` to discover available meetings #### Select Meetings Review titles and participants to identify relevant meetings #### Get Transcripts Use `fireflies_get_transcript` for selected meetings #### Create Minds Build minds from transcript data **Natural language example:** ``` "Show me my team meetings from last month, then create minds for each team member based on their participation" ``` ## See Also #### [fireflies_get_transcript](/mcp-tool-fireflies-get-transcript) Retrieve full transcripts after listing #### [fireflies_search_transcripts](/mcp-tool-fireflies-search-transcripts) Search transcripts by keyword #### [Fireflies Tools Overview](/mcp-integrations-fireflies) See all Fireflies tools and workflows