Skip to main content

​
Overview

The Fireflies MCP (Model Context Protocol) Server provides tools for searching and retrieving meeting transcripts, summaries, and user data. All tools are read-only and operate within your authenticated Fireflies account. For setup and configuration instructions, see MCP Server Configuration.

​
Available Tools

​
Meeting & Transcript Tools

​
fireflies_search
Tool
Description: Advanced search for meeting transcripts using mini grammar syntax.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.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.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.

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

​
Tool Comparison Matrix

ToolContent TypeSummaryParametersBest For
fireflies_searchMultiple meetings✅ YesComplex grammarAdvanced filtering with mini grammar
fireflies_get_transcriptsMultiple meetings✅ YesStructured paramsStructured queries with clear filters
fireflies_get_transcriptSingle meeting❌ NoMeeting ID onlyFull conversation with timestamps
fireflies_fetchSingle meeting✅ YesMeeting ID onlyComplete meeting data in one call
fireflies_get_summarySingle meeting✅ YesMeeting ID onlyQuick insights and action items
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

​
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

​
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