Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.fireflies.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Fireflies MCP (Model Context Protocol) Server provides tools for searching, retrieving, and managing meeting transcripts, summaries, soundbites, channels, and user data. Tools operate within your authenticated Fireflies account — some are read-only while others allow you to take actions like sharing meetings or creating soundbites. For setup and configuration instructions, see MCP Server Configuration.

​
Available Tools

​
Meeting & Transcript Tools

fireflies_search and fireflies_fetch are experimental tools that may not be available to all users. They are being progressively rolled out and may require feature flag enablement.
​
fireflies_search
Tool
Description: Advanced search for meeting transcripts using mini grammar syntax. (Experimental)Parameters:
  • query (string, required) - Search query with grammar syntax
  • format (string) - Response format: “toon” (default), “json”, or “text”
Query Grammar:
  • keyword:"term" - Search keywords
  • scope:title|sentences|all - Search scope
  • from:YYYY-MM-DD - Filter from date
  • to:YYYY-MM-DD - Filter to date
  • limit:N - Max results (50)
  • skip:N - Pagination offset
  • organizers:email1,email2 - Filter by organizers
  • participants:email1,email2 - Filter by participants
  • mine:true|false - User’s meetings only
Example:
{
  "query": "keyword:\"performance\" scope:sentences from:2024-12-01 limit:20"
}
​
fireflies_get_transcripts
Tool
Description: Query multiple meetings with structured filters. Returns metadata and summaries.Parameters:
  • keyword (string) - Search term (max 255 chars)
  • scope (enum) - “title”, “sentences”, or “all”
  • fromDate (string) - ISO date (YYYY-MM-DD)
  • toDate (string) - ISO date (YYYY-MM-DD)
  • limit (number) - Max results (max 50)
  • skip (number) - Pagination offset
  • organizers (array) - Organizer emails
  • participants (array) - Participant emails
  • mine (boolean) - Only user’s meetings
  • format (string) - “toon” (default), “json”, or “text”
Example:
{
  "keyword": "product roadmap",
  "fromDate": "2024-12-01",
  "limit": 20
}
Returns: Meeting IDs, titles, dates, participants, summaries (excludes detailed transcript content).
​
fireflies_get_transcript
Tool
Description: Fetch detailed transcript by ID with sentences, speakers, and timestamps. Excludes summary data. If the meeting is currently live (is_live: true), returns a point-in-time snapshot of the live transcript with sentences captured so far.Parameters:
  • transcriptId (string, required) - Meeting ID
Example:
{
  "transcriptId": "meeting-id-12345"
}
Returns: Sentences with speaker attribution, timestamps, analytics, and metadata.
​
fireflies_fetch
Tool
Description: Retrieve complete meeting data including transcript, summary, and metadata. (Experimental)Parameters:
  • id (string, required) - Meeting ID
Example:
{
  "id": "meeting-id-12345"
}
Returns: Complete meeting data with transcript content, summary, analytics, and metadata.
​
fireflies_get_summary
Tool
Description: Fetch meeting summary by ID with action items, keywords, and overview. Excludes transcript content.Parameters:
  • transcriptId (string, required) - Meeting ID
Example:
{
  "transcriptId": "meeting-id-12345"
}
Returns: Keywords, action items, overview, topics discussed, meeting type, and outline.
​
fireflies_get_active_meetings
Tool
Description: Retrieves a list of currently active (in-progress) meetings. Returns meeting details including ID, title, organizer, meeting link, start/end time, privacy, and state. Admins can query active meetings for any user; regular users can only query their own.Parameters:
  • email (string, optional) - Email address to filter active meetings by a specific user. Admins can query any team member; regular users can only use their own email or omit this field.
  • states (array, optional) - Array of meeting states to filter by. Possible values: "active" (currently in progress), "paused" (meeting has been paused). If omitted, returns meetings in both states.
Example:
{
  "email": "user@example.com",
  "states": ["active"]
}
Returns: List of active meetings with ID, title, organizer, meeting link, start time, privacy, and state.
​
fireflies_get_analytics
Tool
Description: Retrieves team and per-user meeting and conversation analytics. Returns meeting counts, durations, conversation metrics (filler words, questions, monologues, sentiment, talk-listen ratio, words per minute), and comparison data against previous periods. Team-level analytics require admin privileges.Parameters:
  • startTime (string, optional) - Start date/time filter in ISO 8601 format (e.g. "2024-01-01T00:00:00.000Z"). Limits analytics to meetings after this time.
  • endTime (string, optional) - End date/time filter in ISO 8601 format (e.g. "2024-12-31T23:59:59.999Z"). Limits analytics to meetings before this time.
Example:
{
  "startTime": "2024-01-01T00:00:00.000Z",
  "endTime": "2024-12-31T23:59:59.999Z"
}
Returns: Team and per-user meeting counts, durations, and conversation metrics with period-over-period comparisons.

​
Meeting Management Tools

​
fireflies_share_meeting
Tool
Description: Shares a meeting transcript with specified email addresses. The authenticated user must be the owner of the meeting or a team admin. Up to 100 emails can be provided. Optionally set an expiry period for the shared access.Parameters:
  • meetingId (string, required) - The meeting ID / transcript ID to share
  • emails (array, required) - Array of email addresses to share the meeting with (max 100)
  • expiryDays (number, optional) - Expiry period in days for the shared access. Must be one of: 7, 14, 30
Example:
{
  "meetingId": "meeting-id-12345",
  "emails": ["user1@example.com", "user2@example.com"],
  "expiryDays": 14
}
Returns: Confirmation of the sharing operation.
​
fireflies_revoke_meeting_access
Tool
Description: Revokes a previously shared meeting access for a specific email address. The authenticated user must be the owner of the meeting or a team admin.Parameters:
  • meetingId (string, required) - The meeting ID / transcript ID to revoke access from
  • email (string, required) - The email address to revoke access for
Example:
{
  "meetingId": "meeting-id-12345",
  "email": "user@example.com"
}
Returns: Confirmation of the access revocation.
​
fireflies_update_meeting_title
Tool
Description: Updates the title of a meeting transcript. The authenticated user must be the owner of the meeting or a team admin. The title must be between 5 and 256 characters.Parameters:
  • meetingId (string, required) - The meeting ID / transcript ID to update
  • title (string, required) - The new title for the meeting (5-256 characters)
Example:
{
  "meetingId": "meeting-id-12345",
  "title": "Q1 Product Roadmap Review"
}
Returns: Confirmation of the title update.
​
fireflies_move_meeting
Tool
Description: Moves one or more meeting transcripts to a specified channel/folder. The authenticated user must be the owner of the meetings or a team admin. Up to 5 meeting IDs can be provided.Parameters:
  • meetingIds (array, required) - Array of meeting IDs / transcript IDs to move (max 5)
  • channelId (string, required) - The target channel/folder ID to move the meetings to
Example:
{
  "meetingIds": ["meeting-id-1", "meeting-id-2"],
  "channelId": "channel-id-12345"
}
Returns: Confirmation of the move operation.

​
Channel Tools

​
fireflies_list_channels
Tool
Description: Lists all channels/folders available to the authenticated user. Returns channel details including ID, title, privacy setting, and members.Parameters: NoneExample:
{}
Returns: List of channels with ID, title, privacy setting, and member details.
​
fireflies_get_channel
Tool
Description: Retrieves details of a specific channel/folder by its ID. Returns channel title, privacy setting, and member list.Parameters:
  • channelId (string, required) - The ID of the channel to retrieve
Example:
{
  "channelId": "channel-id-12345"
}
Returns: Channel title, privacy setting, and member list.

​
Soundbite Tools

​
fireflies_get_soundbites
Tool
Description: Fetches soundbites (short shareable audio/transcript clips from meetings). Can filter by transcript, ownership, or team. At least one of mine, transcript_id, or my_team must be provided.Parameters:
  • transcript_id (string, optional) - Transcript/meeting ID to get soundbites for a specific meeting
  • mine (boolean, optional) - Filter to only include soundbites owned by the authenticated user
  • my_team (boolean, optional) - Filter to include soundbites from the authenticated user’s team
  • limit (number, optional) - Limit for the number of soundbites to return (max 50)
  • skip (number, optional) - Number of soundbites to skip for pagination
  • format (string) - “toon” (default), “json”, or “text”
Example:
{
  "mine": true,
  "limit": 10
}
Returns: List of soundbites with IDs, names, start/end times, summaries, and associated meeting details.
​
fireflies_create_soundbite
Tool
Description: Creates a soundbite (clip) from a meeting transcript. A soundbite is a short audio/video segment extracted from a meeting. The authenticated user must have write access to the meeting.Parameters:
  • transcriptId (string, required) - The transcript ID / meeting ID to create the soundbite from
  • startTime (number, required) - Start time of the soundbite in seconds (must be >= 0)
  • endTime (number, required) - End time of the soundbite in seconds (must be > 0 and > startTime)
  • name (string, optional) - Name/title for the soundbite (max 256 characters)
  • mediaType (string, optional) - Media type (e.g. “audio”, “video”)
  • privacies (array, optional) - Privacy settings. Values: "public", "team", "participants"
  • summary (string, optional) - Summary text for the soundbite (max 500 characters)
Example:
{
  "transcriptId": "meeting-id-12345",
  "startTime": 120,
  "endTime": 180,
  "name": "Key product decision"
}
Returns: Created soundbite details including ID and share URL.

​
User & Team Tools

​
fireflies_get_user
Tool
Description: Fetch user account details. Returns authenticated user if no ID provided.Parameters:
  • userId (string, optional) - User ID (omit for current user)
Example:
{
  "userId": "user-id-12345"
}
Returns: User ID, email, name, transcript count, recent meeting date, minutes consumed, admin status, and integrations.
​
fireflies_get_usergroups
Tool
Description: Fetch user groups for the authenticated user or team.Parameters:
  • mine (boolean) - true for user’s groups only, false (default) for all team groups
Example:
{
  "mine": false
}
Returns: Group ID, name, handle, members with emails and roles.
​
fireflies_get_user_contacts
Tool
Description: Fetch contact list sorted by most recent meeting date.Parameters:
  • format (string) - “toon” (default), “json”, or “text”
Example:
{
  "format": "json"
}
Returns: Contact emails, names, profile pictures, and last meeting dates.

​
Automation Tools

​
fireflies_get_rule_executions
Tool
Description: Retrieves rule execution logs grouped by meeting. Shows which automation rules were triggered on meetings, including the actions taken (sharing, moving to channels, changing privacy). Requires Enterprise tier access. Results are paginated.Parameters:
  • ruleId (string, optional) - Filter by a specific rule ID
  • meetingId (string, optional) - Filter by a specific meeting ID
  • dateFrom (string, optional) - Filter executions from this date (ISO 8601 format, e.g. "2024-01-01T00:00:00Z")
  • dateTo (string, optional) - Filter executions up to this date (ISO 8601 format, e.g. "2024-12-31T23:59:59Z")
  • limit (number, optional) - Maximum number of meeting groups to return (default: 10, max: 50)
  • cursor (string, optional) - Pagination cursor from a previous response to fetch the next page
Example:
{
  "dateFrom": "2024-01-01T00:00:00Z",
  "dateTo": "2024-12-31T23:59:59Z",
  "limit": 20
}
Returns: Rule execution logs grouped by meeting, including rule names, actions taken, and execution status.

​
Tool Comparison Matrix

ToolContent TypeSummaryParametersBest For
fireflies_searchMultiple meetingsYesComplex grammarAdvanced filtering with mini grammar
fireflies_get_transcriptsMultiple meetingsYesStructured paramsStructured queries with clear filters
fireflies_get_transcriptSingle meetingNoMeeting ID onlyFull conversation with timestamps
fireflies_fetchSingle meetingYesMeeting ID onlyComplete meeting data in one call
fireflies_get_summarySingle meetingYesMeeting ID onlyQuick insights and action items
fireflies_get_active_meetingsActive meetingsNoOptional email/statesMonitoring live meetings
fireflies_get_analyticsTeam analyticsN/AOptional date rangeMeeting and conversation metrics
fireflies_share_meetingSingle meetingN/AMeeting ID + emailsSharing access with others
fireflies_revoke_meeting_accessSingle meetingN/AMeeting ID + emailRemoving shared access
fireflies_update_meeting_titleSingle meetingN/AMeeting ID + titleRenaming meetings
fireflies_move_meetingMultiple meetingsN/AMeeting IDs + channelOrganizing into channels
fireflies_list_channelsChannel listN/ANoneViewing available channels
fireflies_get_channelSingle channelN/AChannel IDChannel details and members
fireflies_get_soundbitesSoundbite listN/AFilter paramsBrowsing meeting clips
fireflies_create_soundbiteSingle soundbiteN/ATranscript ID + timesCreating meeting clips
fireflies_get_userUser dataN/AOptional user IDProfile and account information
fireflies_get_usergroupsTeam dataN/AOptional mine filterTeam structure and membership
fireflies_get_user_contactsContact listN/AOptional formatRecent interaction history
fireflies_get_rule_executionsAutomation logsN/AFilter paramsViewing rule execution history

​
Response Formats

Several tools support multiple response formats via the format parameter:
  • toon (default) - Token-efficient format optimized for AI model consumption
  • json - Standard JSON format for programmatic processing
  • text - Human-readable text format for display

​
Common Workflows

​
Search and Retrieve Pattern

  1. Use fireflies_search or fireflies_get_transcripts to find relevant meetings
  2. Extract meeting IDs from results
  3. Use fireflies_fetch to get complete details, or:
    • Use fireflies_get_transcript for conversation only
    • Use fireflies_get_summary for insights only

​
Team Analysis Pattern

  1. Use fireflies_get_usergroups to get team structure
  2. Extract member emails from target groups
  3. Use fireflies_get_transcripts with participants filter
  4. Optionally use fireflies_get_user for individual member details

​
Contact-Based Search Pattern

  1. Use fireflies_get_user_contacts to get contact list
  2. Find target contact by name or email
  3. Use fireflies_get_transcripts with contact email in participants
  4. Retrieve detailed transcripts or summaries as needed

​
Meeting Management Pattern

  1. Use fireflies_get_transcripts to find meetings to organize
  2. Use fireflies_list_channels to see available channels
  3. Use fireflies_move_meeting to move meetings into channels
  4. Use fireflies_update_meeting_title to rename meetings as needed

​
Soundbite Workflow

  1. Use fireflies_get_transcript to review a meeting’s conversation
  2. Identify key moments by timestamp
  3. Use fireflies_create_soundbite to clip important segments
  4. Use fireflies_get_soundbites to browse existing clips

​
Meeting Sharing Pattern

  1. Use fireflies_get_transcripts to find meetings to share
  2. Use fireflies_share_meeting to share with external or internal users
  3. Use fireflies_revoke_meeting_access to remove access when no longer needed

​
Getting Started

To use these tools:
  1. Configure MCP Server - Add Fireflies MCP Server to your AI application
    • Remote server URL: https://api.fireflies.ai/mcp
    • Supports OAuth or API key authentication
  2. Authenticate - Use OAuth flow or provide API key in configuration
  3. Invoke Tools - Call tools using their standardized names with JSON parameters
For detailed setup instructions, see MCP Server Configuration.

​
Additional Resources

MCP Configuration

Set up the Fireflies MCP Server in your AI application

GraphQL API

Direct GraphQL API access for custom integrations

Authorization

Learn about API authentication and security

LLM Development

Enhance AI coding experience with Fireflies data