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.

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

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

Response

1 {
2   "transcripts": [
3     {
4       "transcriptId": "transcript_abc123",
5       "title": "Weekly Team Standup",
6       "date": "2024-11-15T10:00:00Z",
7       "duration": 1800,
8       "participants": [
9         {
10           "name": "Sarah Chen"
11         },
12         {
13           "name": "Mike Johnson"
14         },
15         {
16           "name": "Alex Rivera"
17         }
18       ]
19     },
20     {
21       "transcriptId": "transcript_def456",
22       "title": "Client Onboarding Call",
23       "date": "2024-11-18T14:00:00Z",
24       "duration": 2700,
25       "participants": [
26         {
27           "name": "Jennifer Wu"
28         },
29         {
30           "name": "Tom Davis"
31         }
32       ]
33     }
34   ],
35   "total": 38,
36   "hasMore": true
37 }

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

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

Solution: Verify your Fireflies API key is configured correctly. See the Fireflies 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.

429 Rate Limit Exceeded

1 {
2   "error": "Rate Limit Exceeded",
3   "message": "Too many requests to Fireflies API"
4 }

Solution: Wait before retrying. Reduce request frequency or use date filtering.

No Transcripts Found

1 {
2   "transcripts": [],
3   "total": 0,
4   "hasMore": false
5 }

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"

fireflies_list_transcripts

Prerequisites

Fireflies Integration Required

Speaker Email Limitation

Parameters

fromDate

toDate

limit

Request

Response

Response Properties

Common Use Cases

Find Recent Meetings

Meeting Discovery

Pre-Search Filtering

Error Responses

401 Unauthorized

400 Bad Request - Invalid Date

429 Rate Limit Exceeded

No Transcripts Found

Best Practices

Use Date Filters

Efficient Discovery

Combine with Search

Integration with Mind Reasoner

Typical Workflow

List Transcripts

Select Meetings

Get Transcripts

Create Minds

See Also