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

fireflies_list_transcripts

List Fireflies meeting transcripts with optional date filtering
Was this page helpful?
Previous

fireflies_get_transcript

Retrieve detailed transcripts from Fireflies with speaker analytics
Next
Built with
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

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

toDate

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

limit

Typenumber
RequiredNo
DescriptionMaximum number of transcripts 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 "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

PropertyTypeDescription
transcriptsarrayArray of transcript objects with metadata
transcripts[].transcriptIdstringUnique identifier for the transcript (use with other Fireflies tools)
transcripts[].titlestringMeeting title from calendar
transcripts[].datestringISO 8601 timestamp of when the meeting occurred
transcripts[].durationnumberMeeting duration in seconds
transcripts[].participantsarrayArray of participant objects
transcripts[].participants[].namestringParticipant’s name (email not available in list view)
totalnumberTotal number of transcripts matching the filter criteria
hasMorebooleanWhether 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

1

List Transcripts

Use fireflies_list_transcripts to discover available meetings

2

Select Meetings

Review titles and participants to identify relevant meetings

3

Get Transcripts

Use fireflies_get_transcript for selected meetings

4

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

Retrieve full transcripts after listing

fireflies_search_transcripts

Search transcripts by keyword

Fireflies Tools Overview

See all Fireflies tools and workflows