--- name: fireflies-cc4a05d5131f description: Access Fireflies.ai meeting transcripts, summaries, action items, and analytics via GraphQL API metadata: {"clawdbot":{"secrets":["FIREFLIES_API_KEY"]}} --- # Fireflies.ai Skill Query meeting transcripts, summaries, action items, and analytics from Fireflies.ai. ## Setup Set your Fireflies API key: ```bash FIREFLIES_API_KEY=your_api_key_here ``` Get your API key from: https://app.fireflies.ai/integrations (scroll to Fireflies API section) ## API Base GraphQL Endpoint: `https://api.fireflies.ai/graphql` Authorization header: `Bearer $FIREFLIES_API_KEY` --- ## Core Queries ### Get Current User ```bash curl -s -X POST https://api.fireflies.ai/graphql \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -d '{"query":"{ user { user_id name email is_admin minutes_consumed num_transcripts recent_meeting } }"}' | jq ``` ### Get Single Transcript ```bash curl -s -X POST https://api.fireflies.ai/graphql \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -d '{"query":"query($id:String!){transcript(id:$id){id title date duration participants fireflies_users summary{keywords action_items overview topics_discussed} speakers{name duration} sentences{speaker_name text start_time}}}","variables":{"id":"TRANSCRIPT_ID"}}' | jq ``` ### Search Transcripts by Date Range ```bash # ISO 8601 format: YYYY-MM-DDTHH:mm:ss.sssZ curl -s -X POST https://api.fireflies.ai/graphql \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -d '{"query":"query($from:DateTime,$to:DateTime,$limit:Int){transcripts(fromDate:$from,toDate:$to,limit:$limit){id title date duration organizer_email participants summary{keywords action_items overview}}}","variables":{"from":"2024-01-01T00:00:00.000Z","to":"2024-01-31T23:59:59.999Z","limit":50}}' | jq ``` ### Search Transcripts by Participant ```bash # Search meetings where specific people participated curl -s -X POST https://api.fireflies.ai/graphql \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -d '{"query":"query($participants:[String],$limit:Int){transcripts(participants:$participants,limit:$limit){id title date participants organizer_email summary{action_items}}}","variables":{"participants":["john@example.com","jane@example.com"],"limit":20}}' | jq ``` ### Search Transcripts by Organizer ```bash curl -s -X POST https://api.fireflies.ai/graphql \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -d '{"query":"query($organizers:[String],$limit:Int){transcripts(organizers:$organizers,limit:$limit){id title date organizer_email participants}}","variables":{"organizers":["sales@example.com"],"limit":25}}' | jq ``` ### Search by Keyword (Title and/or Transcript) ```bash # scope: "TITLE", "SENTENCES", or "ALL" curl -s -X POST https://api.fireflies.ai/graphql \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -d '{"query":"query($keyword:String,$scope:String){transcripts(keyword:$keyword,scope:$scope,limit:10){id title date summary{overview}}}","variables":{"keyword":"pricing","scope":"ALL"}}' | jq ``` ### Get My Recent Transcripts ```bash curl -s -X POST https://api.fireflies.ai/graphql \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -d '{"query":"{ transcripts(mine:true,limit:10) { id title date duration summary { action_items keywords } } }"}' | jq ``` --- ## Advanced Queries ### Get Full Transcript with Summary & Action Items ```bash curl -s -X POST https://api.fireflies.ai/graphql \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -d '{"query":"query($id:String!){transcript(id:$id){id title date duration organizer_email participants fireflies_users workspace_users meeting_attendees{displayName email} summary{keywords action_items outline overview bullet_gist topics_discussed meeting_type} speakers{name duration word_count} sentences{speaker_name text start_time end_time}}}","variables":{"id":"TRANSCRIPT_ID"}}' | jq ``` ### Get Transcript with Analytics ```bash # Requires Pro plan or higher curl -s -X POST https://api.fireflies.ai/graphql \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -d '{"query":"query($id:String!){transcript(id:$id){id title analytics{sentiments{positive_pct neutral_pct negative_pct} speakers{name duration word_count filler_words questions longest_monologue words_per_minute}}}}","variables":{"id":"TRANSCRIPT_ID"}}' | jq ``` ### Get Contacts ```bash curl -s -X POST https://api.fireflies.ai/graphql \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -d '{"query":"{ contacts { email name picture last_meeting_date } }"}' | jq ``` ### Get Active Meetings ```bash curl -s -X POST https://api.fireflies.ai/graphql \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -d '{"query":"{ active_meetings { id title organizer_email meeting_link start_time state } }"}' | jq ``` --- ## Pipeline Review Example Get all meetings from last 7 days with specific participants: ```bash FROM_DATE=$(date -u -v-7d +"%Y-%m-%dT00:00:00.000Z") # macOS TO_DATE=$(date -u +"%Y-%m-%dT23:59:59.999Z") curl -s -X POST https://api.fireflies.ai/graphql \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -d "{\"query\":\"query(\$from:DateTime,\$to:DateTime,\$participants:[String]){transcripts(fromDate:\\\"\$FROM_DATE\\\",toDate:\\\"\$TO_DATE\\\",participants:\$participants,limit:50){id title date duration organizer_email participants summary{keywords action_items topics_discussed meeting_type}}}\",\"variables\":{\"from\":\"$FROM_DATE\",\"to\":\"$TO_DATE\",\"participants\":[\"prospect@company.com\"]}}" | jq ``` --- ## Key Schema Fields ### Transcript Fields - `id` - Unique identifier - `title` - Meeting title - `date` - Unix timestamp (milliseconds) - `dateString` - ISO 8601 datetime - `duration` - Duration in minutes - `organizer_email` - Meeting organizer - `participants` - All participant emails - `fireflies_users` - Fireflies users who participated - `workspace_users` - Team members who participated - `meeting_attendees` - Detailed attendee info (displayName, email) - `transcript_url` - View in dashboard - `audio_url` - Download audio (Pro+, expires 24h) - `video_url` - Download video (Business+, expires 24h) ### Summary Fields - `keywords` - Key topics - `action_items` - Extracted action items - `overview` - Meeting overview - `topics_discussed` - Main topics - `meeting_type` - Meeting category - `outline` - Structured outline - `bullet_gist` - Bullet point summary ### Sentence Fields - `text` - Sentence text - `speaker_name` - Who said it - `start_time` - Timestamp (seconds) - `end_time` - End timestamp - `ai_filters` - Filters (task, question, pricing, etc.) ### Speaker Fields - `name` - Speaker name - `duration` - Speaking time - `word_count` - Words spoken - `filler_words` - Filler word count - `questions` - Questions asked - `longest_monologue` - Longest uninterrupted speech - `words_per_minute` - Speaking pace --- ## Filter Examples ### By Date Range (ISO 8601) ```json { "fromDate": "2024-01-01T00:00:00.000Z", "toDate": "2024-01-31T23:59:59.999Z" } ``` ### By Multiple Participants ```json { "participants": ["user1@example.com", "user2@example.com"] } ``` ### By Channel ```json { "channel_id": "channel_id_here" } ``` ### Combined Filters ```json { "fromDate": "2024-01-01T00:00:00.000Z", "toDate": "2024-01-31T23:59:59.999Z", "participants": ["sales@example.com"], "keyword": "pricing", "scope": "ALL", "limit": 50 } ``` --- ## PowerShell Examples ```powershell $headers = @{ "Authorization" = "Bearer $env:FIREFLIES_API_KEY" "Content-Type" = "application/json" } # Get recent transcripts $body = @{ query = "{ transcripts(mine:true,limit:10) { id title date } }" } | ConvertTo-Json Invoke-RestMethod -Uri "https://api.fireflies.ai/graphql" -Method POST -Headers $headers -Body $body ``` --- ## Notes - **Rate Limits**: Check with Fireflies support for current limits - **Pagination**: Use `limit` (max 50) and `skip` for large result sets - **Date Format**: Always use ISO 8601 format: `YYYY-MM-DDTHH:mm:ss.sssZ` - **Audio/Video URLs**: Expire after 24 hours, regenerate as needed - **Analytics**: Requires Pro plan or higher - **Video Recording**: Must be enabled in dashboard settings --- ## Common Use Cases 1. **Weekly Pipeline Review**: Search transcripts by date + participants 2. **Follow-up Tasks**: Extract action items from recent meetings 3. **Competitor Mentions**: Search keyword in sentences 4. **Speaking Analytics**: Analyze talk time, questions asked 5. **Meeting Insights**: Get summaries and key topics --- Source attribution: kbarbel640-del Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/daniil-ctrl/fireflies/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Dave AI. ## Upstream license notice MIT License Copyright (c) 2026 clawdbot Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Dave AI resource metadata Creator / publisher: kbarbel640-del Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/daniil-ctrl/fireflies/SKILL.md Attribution basis: Source repository record Fields of work: Marketing, Product Management, Sales Roles: Customer Success Manager, Marketing Analyst, Product Manager, Sales Operations, Sales Development Rep (SDR) Specialties: API Tools: Fireflies.Ai Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 8ff5ede6ab608e07eb7978c23b46a8c616d7bc3de955051a3976a90cb15a362f