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 and transcripts.
Capabilities
- Meeting capture & ingestion: Dispatch the Fireflies notetaker bot into a live meeting or upload an existing audio/video file for async transcription.
- Search & retrieval: Find past meetings by title, participants, date, or spoken content; list channels, contacts, and soundbites with flexible scoping filters.
- Summaries, transcripts & Q&A: Fetch AI-generated notes (overview, action items, keywords), retrieve verbatim transcripts with time-windowing, or ask grounded natural-language questions with conversational follow-up.
- Analytics: Get per-speaker talk-time, speaking pace, and sentiment for individual meetings, or aggregate those metrics across a team's calls over a rolling 30-day window.
- Collaboration: Share or revoke meeting access with teammates; clip soundbites from recordings for sharing or reference.
- Account introspection: Retrieve the caller's own Fireflies identity and usage summary.
Secrets
FIREFLIES_API_KEY — A personal API key issued by Fireflies that authenticates every GraphQL request made on behalf of your account. To obtain one: log in to Fireflies, open Integrations → API Access (or navigate directly to https://app.fireflies.ai/api-integrations), and generate or copy your API key. The key is tied to your user account and carries full access to your meetings and team data, so treat it as a credential. See the Fireflies API docs for details.
Store the key as an Arcade secret. See the Arcade secrets guide and the Arcade secrets dashboard.
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 |