Fireflies
Arcade toolkit · docs.arcade.dev
Arcade toolkit for interacting with the Fireflies meeting intelligence API. Enables agents and tools to record, search, analyze, and manage meetings, transcripts, and follow-ups programmatically.
Capabilities
- Meeting capture & ingestion: Dispatch the Fireflies notetaker bot into a live meeting or queue an existing audio/video file for async transcription.
- Search & retrieval: Find past meetings by title, participants, date, or spoken topic; retrieve AI-generated summaries, action items, keywords, and outlines in a single call.
- Transcript access: Fetch verbatim, speaker-attributed transcripts with time-window and offset filtering to keep responses manageable on long calls.
- Analytics & AI Q&A: Pull per-speaker talk-time, pace, and sentiment for individual meetings or aggregated across a team over a rolling 30-day window; ask grounded natural-language questions about a meeting with threaded follow-up support.
- Soundbites & sharing: Clip time-ranged soundbites from recordings; share or revoke teammate access to meeting notes and recordings.
- Account & organization utilities: List channels, contacts, and soundbites; inspect caller identity and usage quota.
Secrets
FIREFLIES_API_KEY — A Fireflies API key that authenticates all requests to the Fireflies GraphQL API. To obtain one, log in to your Fireflies account, go to Integrations → API Key (or navigate directly to https://app.fireflies.ai/integrations/custom/fireflies), and generate or copy your personal API key. The key is tied to your Fireflies account identity — WhoAmI and all meeting-management operations (sharing, revoking, uploading) act as that user. A paid or trial Fireflies plan may be required to access API features; check your plan's API entitlements in the Fireflies dashboard.
For guidance on storing secrets in Arcade, see the Arcade secrets docs. You can also manage secrets directly at https://api.arcade.dev/dashboard/auth/secrets.
Tools17
Fireflies_AddNotetakerToLiveMeeting
Send the Fireflies notetaker into a live meeting to capture it. The bot can take up to a minute to join after a successful dispatch.
Fireflies_AnalyzeTeamMeetings
Aggregate team conversation metrics and a per-speaker breakdown over a date range. Use this to spot team-level trends across meetings in a window no wider than 30 days. Aggregates are rolled up from each meeting's own analytics, so the sentiment and talk-time reflect every call in the window (not just the calls of mapped team users). The most recent 50 meetings in the range are aggregated; when more fall in the range the result's truncated flag is set so partial aggregates are not read as complete.
Fireflies_AskAboutMeeting
Ask a grounded question about a meeting and get an AI answer with suggested follow-ups. Prefer this over reading the full transcript when the user has a specific question. Pass the returned thread id back as thread_id to continue the same conversation.
Fireflies_CreateSoundbite
Clip a soundbite from a time range within a recorded meeting. The new clip processes asynchronously; the result reports its initial processing state. Use the soundbite read tools to retrieve it once ready.
Fireflies_GetMeetingAnalytics
Get per-speaker talk-time and pace plus the sentiment breakdown for one meeting. Use this to gauge how a call went -- who dominated, speaking pace, and overall sentiment. Analytics may be sparse or empty for very short calls.
Fireflies_GetMeetingSummary
Get Fireflies' AI-generated notes for a meeting: overview, action items, keywords, outline. Use this single call to answer "what were the takeaways / action items from this call?"; it is far cheaper and more reliable than reading the verbatim transcript.
Fireflies_GetMeetingTranscript
Get the verbatim spoken lines of a meeting, in chronological order with speaker attribution. Fireflies serves a meeting's lines only as a whole, so each call retrieves the full transcript; limit, offset, and the from_time/to_time window then bound what is returned to keep the response small (they do not reduce what is fetched upstream). Transcripts can run to thousands of lines, so request a narrow window. To quote a moment found via the AI question or notes tools (which report timestamps in seconds), pass from_time and/or to_time; offset and limit then apply within that window. For takeaways or action items, prefer the AI meeting-notes tool over reading raw lines.
Fireflies_GetSoundbite
Get a single soundbite by id. Returns a graceful not-found result instead of raising for an unknown or inaccessible id, so lookups compose like the list/search tools.
Fireflies_ListActionItems
Gather follow-ups from recent meetings into one flat list to answer "what do I owe?". Each meeting's AI action-items notes are flattened into individual, owner-attributed items so the caller's outstanding follow-ups across many calls surface in one request rather than by opening each meeting. Prefer this over reading each call's notes separately when triaging open commitments; set assigned_to_me to narrow to the caller's own follow-ups, or assignee_email to narrow to a specific teammate's.
Fireflies_ListChannels
List the channels meetings are filed into. A channel's id can be passed to a meeting search to narrow results to that channel, so this is the lookup behind that filter as well as a view of how the account organizes its calls.
Fireflies_ListContacts
List the people the caller has met with, most recent first.
Fireflies_ListSoundbites
List soundbites, optionally scoped to your own, your team's, or a single meeting's.
Fireflies_RevokeMeetingAccess
Remove a previously granted teammate's access to a meeting. You can only manage sharing on a meeting you own or manage. Revoking an email that does not currently have access is not a silent no-op: Fireflies may return a failed status, so treat a failed result as "no change was made" rather than a hard error.
Fireflies_SearchMeetings
Find a recorded meeting by its title, the people on it, when it happened, or its topic. Use this single call to locate a past call; results are newest first. By default the keyword matches the meeting title only; switch match to content to find a call by its spoken topics -- that scans each recent meeting's AI notes (gist, summary, keywords, topics, action items) and keeps the ones whose notes or title contain the keyword. Each result carries a one-line AI gist for triage; set include_notes to also pull each call's short summary and action items in the same request (the standup-prep digest).
Fireflies_ShareMeeting
Grant one or more teammates access to a meeting's notes and recording. You can only share a meeting you own or manage. Re-sharing an email that already has access is not a silent no-op: Fireflies may return a failed status, so treat a failed result as "no change was made" rather than relying on this call to idempotently ensure access.
Fireflies_UploadRecording
Queue an already-recorded audio or video file for Fireflies transcription. Use this for a recording that exists elsewhere; use the live-notetaker tool to capture a meeting happening now. Transcription runs asynchronously after queuing.
Fireflies_WhoAmI
Get the caller's own Fireflies identity and usage summary.