Fireflies
Arcade.dev tools for interacting with Fireflies
0.3.0Fireflies is an AI meeting assistant platform. This toolkit lets Arcade agents interact with Fireflies to capture, search, analyze, and share meeting recordings, transcripts, and AI-generated notes.
Capabilities
- Meeting capture & ingestion — send a live notetaker bot into an active meeting or upload an existing audio/video file for async transcription.
- Search & retrieval — locate past meetings by title, participants, date, or spoken topic; list contacts and organizational channels for scoped filtering.
- Transcripts & AI notes — fetch verbatim, speaker-attributed transcripts with time-window controls, or pull AI-generated summaries, action items, keywords, and outlines in a single call.
- Analytics — retrieve per-speaker talk-time, pace, and sentiment for individual meetings, or roll up those metrics across a team over a date window (up to 30 days, up to 50 meetings).
- Soundbites — clip, retrieve, and list soundbite segments clipped from recorded meetings.
- Sharing & access control — grant or revoke teammate access to meetings the caller owns or manages.
Secrets
FIREFLIES_API_KEY — A Fireflies API key that authenticates every GraphQL request to the Fireflies API. To obtain one, log into your Fireflies account, open Settings → API (or navigate directly to https://app.fireflies.ai/account-settings/api), and generate a new API key. The key is tied to your Fireflies user account and inherits your account's permissions; a paid or Business-tier plan may be required for full API access. Copy the key immediately — Fireflies does not redisplay it after initial generation.
Store this secret in Arcade at https://api.arcade.dev/dashboard/auth/secrets. For details on how Arcade handles tool secrets, see https://docs.arcade.dev/en/guides/create-tools/tool-basics/create-tool-secrets.
Available tools(17)
| Tool name | Description | Secrets | |
|---|---|---|---|
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. | 1 | ||
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. | 1 | ||
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. | 1 | ||
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. | 1 | ||
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. | 1 | ||
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. | 1 | ||
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. | 1 | ||
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. | 1 | ||
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. | 1 | ||
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. | 1 | ||
List the people the caller has met with, most recent first. | 1 | ||
List soundbites, optionally scoped to your own, your team's, or a single meeting's. | 1 | ||
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. | 1 | ||
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). | 1 | ||
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. | 1 | ||
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. | 1 | ||
Get the caller's own Fireflies identity and usage summary. | 1 |