Fireflies connector for AI agents

Tools your meeting notes agent reaches for on Fireflies, scoped per user.

CALL ANY TOOL

36 tools for meeting notes in Fireflies: list and read transcripts, ask AskFred, upload recordings, send the bot into live meetings, create bites, share and update meetings, and read team analytics.

fireflies_active_meetings_list

List active meetings

List the meetings the Fireflies bot is currently in (in progress, either recording or paused), optionally for one user's email or only those in the active or paused state. Returns each meeting's id, title, organizer email, meeting link, start time, scheduled end time, privacy setting, and state (active or paused). Use this to find the meeting ID that fireflies_live_action_items_list, fireflies_live_action_item_create, fireflies_live_soundbite_create, and fireflies_meeting_state_update need. Use fireflies_transcripts_list for finished meetings, and fireflies_live_meeting_add to send the bot into a call it is not yet in. Regular users can only list their own meetings; listing another user's meetings needs admin privileges and a user in the same team. Fireflies can answer HTTP 200 with an errors array next to partial data, so use whatever data is present instead of treating the call as failed.

Parameters

Name

Type

Required

Description

string

Optional

Email address of the team member whose in-progress meetings to list. Omit it to list the connected user's own meetings. Regular users can only pass their own email; admins can pass the email of any user in their team. The email must belong to a user in the same team as the connected user. Example: rep@company.com

states

array

Optional

Only return meetings in these states. active means the Fireflies bot is in the meeting and actively recording; paused means the bot is still in the meeting but recording is temporarily stopped. Omit it to return meetings in both states; an empty list is treated the same as omitting it. Example: ["active"]

fireflies_analytics_get

Get analytics

fireflies_apps_list

List apps

fireflies_askfred_thread_continue

Askfred thread continue

Add a follow-up question to an existing AskFred conversation thread and get the AI-generated answer, with the thread's earlier questions and answers kept as context. Returns the new message with its id, thread_id, query, answer, suggested_queries (follow-up questions), status, created_at, and updated_at, plus the cost in AI credits charged. Use this to keep a conversation going in a thread you already have. Use fireflies_askfred_thread_create to start a new conversation, fireflies_askfred_thread_get to re-read the whole thread, and fireflies_askfred_threads_list to find a thread ID. Requires a thread ID from fireflies_askfred_threads_list or fireflies_askfred_thread_create. Each call appends a new message to that thread and spends AI credits; the API has no operation to remove a single message, so the only way to undo it is to delete the whole thread with fireflies_askfred_thread_delete. Fireflies returns object_not_found when the thread does not exist or is not accessible, require_ai_credits when the account has insufficient AI credits (upgrade the plan or purchase additional credits), and invalid_language_code for an unsupported response_language. Fireflies can answer HTTP 200 with an errors array next to partial data, so read errors before assuming the change was applied and use whatever data is present.

Parameters

Name

Type

Required

Description

query

string

Required

The follow-up question to ask inside the existing thread, as a non-empty natural-language question of up to 2000 characters. AskFred answers it with the earlier questions and answers of the thread as context. Example: Can you provide more details about the budget allocation?

thread_id

string

Required

ID of the existing AskFred thread to continue, taken from the id field returned by fireflies_askfred_threads_list or from the thread_id on the message returned by fireflies_askfred_thread_create. Example: thread_abc123

format_mode

string

Optional

Format of the answer text. Use markdown for rich formatting with headers, lists, and bold or italic text. Use plaintext for concise text without any formatting, suitable for systems that cannot render markdown. Leave blank to use the Fireflies default. Example: markdown. One of: `markdown`, `plaintext`.

generate_suggestions

boolean

Optional

Whether Fireflies generates suggested follow-up questions, returned as suggested_queries on the new message. This tool always reads suggested_queries, so leaving this blank generates them. Set false to skip them for a faster response, in which case suggested_queries comes back null. Set true to force generation, which adds some latency. Example: false

response_language

string

Optional

Language code for the answer, such as en for English or es for Spanish. Leave blank to let Fireflies choose the language. Fireflies returns invalid_language_code when the code is not supported; the supported codes are listed on the Fireflies Language Codes documentation page. Example: es

fireflies_askfred_thread_create

Create askfred thread

Start a new AskFred conversation thread by asking one question about a single Fireflies meeting, or about the meetings picked by filters, and get the AI-generated answer. Returns the new message with its id, thread_id, query, answer, suggested_queries (follow-up questions), status, created_at, and updated_at, plus the cost in AI credits charged. Keep the thread_id to continue the conversation. Use this to begin a new conversation, and use fireflies_transcript_get instead when a meeting's stored transcript or summary is enough. Use fireflies_askfred_thread_continue to ask a follow-up inside an existing thread, fireflies_askfred_thread_get to re-read a thread, and fireflies_askfred_thread_delete to remove a thread you no longer need. Each call adds a new thread to the connected user's AskFred history and spends AI credits. Fireflies returns require_ai_credits when the account has no access to AI credits (a plan upgrade is needed), object_not_found when transcript_id does not exist or is not accessible, invalid_language_code for an unsupported response_language, and invalid_arguments when the query is empty or over 2000 characters, when both transcript_id and filters are given, or when filters.start_time is more than 1 year in the past or not before end_time. Fireflies can answer HTTP 200 with an errors array next to partial data, so read errors before assuming the change was applied and use whatever data is present.

Parameters

Name

Type

Required

Description

query

string

Required

The question to ask AskFred about your meetings, as a natural-language question of 1 to 2000 characters. An empty question or one longer than 2000 characters makes Fireflies return invalid_arguments. Example: What action items came out of the Q4 planning meeting?

filters

object

Optional

Criteria that select which meetings AskFred searches when the question is not tied to one transcript_id. Provide either transcript_id or filters, not both: sending both makes Fireflies return invalid_arguments. Use start_time and end_time (ISO 8601 timestamps) for a time window, then narrow further with channel_ids, organizers (email addresses), participants (email addresses), and transcript_ids. Omit any criterion you do not need. When start_time is omitted it defaults to 30 days before end_time, and when end_time is omitted it defaults to today; start_time cannot be more than 1 year in the past and must be before end_time, so pick a window that falls inside the past year. Example (adjust the dates so the window falls within the past year): {"start_time": "2026-09-01T00:00:00.000Z", "end_time": "2026-09-30T23:59:59.000Z", "participants": ["buyer@customer.com"]}

format_mode

string

Optional

generate_suggestions

boolean

Optional

response_language

string

Optional

transcript_id

string

Optional

ID of one Fireflies transcript to ask about, taken from the id field returned by fireflies_transcripts_list. AskFred then answers from only that meeting. Provide either transcript_id or filters, not both: sending both makes Fireflies return invalid_arguments. Leave blank when you use filters instead. Example: 01HZX2ABCDEF3GHJKMNPQRSTVW

fireflies_askfred_thread_delete

Delete askfred thread

fireflies_askfred_thread_get

Get askfred thread

fireflies_askfred_threads_list

List askfred threads

fireflies_audio_upload

Upload audio

Upload an audio or video recording from a URL to Fireflies for transcription, optionally with a title, attendees, language, webhook, and meeting date. Returns success, the title Fireflies gave the file, and a status message confirming the file was queued for processing. The transcript is created afterwards, so the response carries no transcript ID or text; pass a webhook URL to be notified, then find the new meeting with fireflies_transcripts_list. Use this to import an existing recording from an https link to an mp3, mp4, wav, m4a, or ogg file; the link can be public, a signed URL, or protected with credentials passed in download_auth. Use fireflies_live_meeting_add to record a meeting that is happening now. Passing attendees can make Fireflies write the notes to connected CRMs such as Salesforce or HubSpot, adding them to or creating a contact, so include attendees only when the user wants that. An unwanted upload can be removed with fireflies_transcript_delete once it appears in fireflies_transcripts_list. Requires a paid Fireflies plan (free plan users get a paid_required error), uploads not disabled by the organization admin (otherwise feature_disabled), and a file of at least 50 kB unless bypass_size_check is true (otherwise payload_too_small). Fireflies can answer HTTP 200 with an errors array next to partial data, so read errors before assuming the change was applied and use whatever data is present.

Parameters

Name

Type

Required

Description

url

string

Required

Direct HTTPS link to the audio or video file Fireflies should download and transcribe. The link must be publicly reachable, or reachable with the credentials in download_auth, and must download the file itself rather than open a preview page. Supported formats: mp3, mp4, wav, m4a, ogg. Files on a local machine cannot be uploaded. A signed URL with a short expiry (for example an AWS S3 presigned URL) works for private files. Example: https://example.com/recordings/q3-pipeline-review.mp3

attendees

array

Optional

People who were in the recorded meeting, up to 100. Each attendee can have a displayName (the name shown in the meeting platform, such as Zoom or Google Chat), an email, and a phoneNumber. Fireflies uses attendees to push the meeting notes to active CRM integrations such as Salesforce or HubSpot, adding the notes to an existing contact or creating a new one. All three attendee fields are optional. Example: [{"displayName": "Dana Rivera", "email": "dana@acme.com", "phoneNumber": "+14155550123"}]

bypass_size_check

boolean

Optional

Set to true to skip Fireflies' file size validation, which normally rejects audio files smaller than 50 kB with the payload_too_small error. Use it only for very short clips. Example: true

client_reference_id

string

Optional

Your own identifier for this upload, up to 128 characters. Fireflies includes it in webhook events so you can tell which upload an event belongs to. Example: crm-call-48213

custom_language

string

Optional

Language code of the spoken audio so Fireflies transcribes in that language, for example es for Spanish or de for German. An unrecognized code makes Fireflies return invalid_language_code; the valid codes are listed on the Fireflies Language Codes documentation page. Example: es

download_auth

object

Optional

Credentials Fireflies uses when downloading a media file that sits behind authentication. Leave it out for a publicly reachable URL. The object has a required type that says which method to use: none for a public file, bearer_token to send an Authorization: Bearer header, or basic_auth to send HTTP Basic credentials. With bearer_token, also provide bearer with the token. With basic_auth, also provide basic with a password and, optionally, a username. Provide only the block that matches type; Fireflies rejects mixed methods. The media URL must use HTTPS, and Fireflies uses the credentials only to download the file and does not store them permanently. Example: {"type": "bearer_token", "bearer": {"token": "your-bearer-token"}}

meeting_date

string

Optional

Date and time the meeting actually took place, as an ISO 8601 datetime. Offsets are normalized to UTC and nonexistent calendar dates are rejected. Use it when importing historical recordings so the meeting is dated correctly. It must not be in the future. If omitted, Fireflies uses the upload time. Example: 2026-03-14T15:00:00Z

save_video

boolean

Optional

Set to true to save the video of the uploaded file, or false to not save it. Example: true

title

string

Optional

Title for the new meeting transcript, up to 256 characters. If omitted, Fireflies uses the file's original name. Example: Q3 Pipeline Review with Acme

webhook

string

Optional

URL of a webhook that Fireflies notifies when transcription of this upload completes. Use it to learn when the transcript is ready, because the upload response does not contain the transcript ID. Example: https://example.com/hooks/fireflies-transcription-done

fireflies_audit_events_list

List audit events

List audit events (Beta) for the connected Fireflies team within one category, optionally narrowed to one action, a date range, or the person who performed it. Returns each event's id, time, category, action, severity, status, message, the actor (user_id, email, full_name, ip_address, any of which can be null), the affected resource (type and id), the OCSF class_uid, activity_id, and type_uid, and a metadata JSON string whose keys depend on the action, plus has_more and next_cursor for paging. Use this to see who deleted, viewed, shared, downloaded, or changed meetings, teammates, roles, and settings, and who logged in or out. Use fireflies_rule_executions_list for what Fireflies automation rules did to meetings, and fireflies_users_list to resolve actor user IDs and emails. Requires an Enterprise plan and an API key that belongs to a team admin (otherwise Fireflies returns paid_required or require_elevated_privilege). category is required. Page with limit (1 to 50) and the next_cursor value of the previous page while has_more is true. Fireflies can answer HTTP 200 with an errors array next to partial data, so use whatever data is present instead of treating the call as failed.

Parameters

Name

Type

Required

Description

category

string

Required

Group of audit events to return. Required. MEETING_OPERATIONS covers meeting deleted, privacy updated, viewed, shared, access revoked, downloaded, title updated, moved to a channel, and soundbite created. TEAM_OPERATIONS covers teammate added or removed and user group members added or removed. USER_OPERATIONS covers user role changes and team settings updates. AUTHENTICATION covers user login and logout. Example: MEETING_OPERATIONS. One of: `MEETING_OPERATIONS`, `TEAM_OPERATIONS`, `USER_OPERATIONS`, `AUTHENTICATION`.

action

string

Optional

Return only events of this specific action, which must belong to the chosen category. MEETING_OPERATIONS actions: MEETING_DELETED, MEETING_PRIVACY_UPDATED, MEETING_VIEWED (a meeting summary was viewed), MEETING_SHARED, MEETING_ACCESS_REVOKED, MEETING_DOWNLOADED (a transcript or recording was downloaded), MEETING_TITLE_UPDATED, MEETING_MOVED_TO_CHANNEL, SOUNDBITE_CREATED. TEAM_OPERATIONS actions: TEAMMATE_ADDED, TEAMMATE_REMOVED, USER_GROUP_MEMBER_ADDED, USER_GROUP_MEMBER_REMOVED. USER_OPERATIONS actions: USER_ROLE_CHANGED, SETTINGS_UPDATED. AUTHENTICATION actions: LOGIN, LOGOUT. Leave empty to return every action in the category. Example: MEETING_DELETED. One of: `MEETING_DELETED`, `MEETING_PRIVACY_UPDATED`, `MEETING_VIEWED`, `MEETING_SHARED`, `MEETING_ACCESS_REVOKED`, `MEETING_DOWNLOADED`, `MEETING_TITLE_UPDATED`, `MEETING_MOVED_TO_CHANNEL`, `SOUNDBITE_CREATED`, `TEAMMATE_ADDED`, `TEAMMATE_REMOVED`, `USER_ROLE_CHANGED`, `USER_GROUP_MEMBER_ADDED`, `USER_GROUP_MEMBER_REMOVED`, `SETTINGS_UPDATED`, `LOGIN`, `LOGOUT`.

actor_email

string

Optional

Return only events performed by the Fireflies user with this email address. Fireflies resolves the email to a user ID, and it takes precedence over actor_user_id when both are set. Example: alice@example.com

actor_user_id

string

Optional

Return only events performed by the Fireflies user with this user ID, as returned in user_id by fireflies_users_list or in an earlier event's actor. If actor_email is also set, actor_email takes precedence and this value is ignored. Example: user_abc123

cursor

string

Optional

Paging cursor. Pass the next_cursor value from the previous response to fetch the next page, and keep the same category and filters. Omit it for the first page. Example: eyJpZCI6IjdhMWM0ZDVlIn0=

date_from

string

Optional

Return only events that occurred from this date, as an ISO 8601 timestamp. Example: 2026-10-01T00:00:00.000Z

date_to

string

Optional

Return only events that occurred up to this date, as an ISO 8601 timestamp. Example: 2026-10-14T23:59:59.000Z

limit

integer

Optional

Maximum number of events to return, from 1 to 50. Defaults to 20. Use next_cursor to fetch further pages. Example: 20. Default: `20`.

fireflies_bite_create

Create bite

Create a bite, a short clip (also called a soundbite), from a finished Fireflies meeting by giving the start and end time of the moment, with an optional name, summary, media type, and visibility. Returns the new bite's id, name, summary, processing status (pending, processing, ready, or error; a new bite starts as pending while Fireflies processes the clip), media type, start and end time, privacies, creator, source meeting, and thumbnail, preview, and media source links. Setting privacies to public lets anyone with the bite's link open it. The Fireflies API has no operation to delete a bite, so this cannot be undone through the API, and repeating the call may create another bite. Use this to clip a moment from a finished meeting by time range. Use fireflies_live_soundbite_create to capture a moment in a meeting that is still in progress from a natural-language prompt, fireflies_bite_get to check whether the new bite is ready, and fireflies_bites_list to see existing bites. Requires a transcript ID from fireflies_transcripts_list and the start and end time of the moment in seconds, which you can read from the sentences returned by fireflies_transcript_get. If the response includes an errors array, the bite may still have been created: call fireflies_bites_list with the transcript_id to check before retrying, and use whatever data is present.

Parameters

Name

Type

Required

Description

end_time

number

Required

Where the bite ends, in seconds, as a number that can have decimals. It must be greater than start_time. To clip a specific moment, use the end_time of its last sentence from fireflies_transcript_get; Fireflies does not state the unit of those sentence times, so check the clip it creates. Example: 75.5

start_time

number

Required

Where the bite starts, in seconds, as a number that can have decimals. It must be less than end_time. To clip a specific moment, use the start_time of its first sentence from fireflies_transcript_get; Fireflies does not state the unit of those sentence times, so check the clip it creates. Example: 30

transcript_id

string

Required

ID of the transcript (meeting) to cut the bite from, taken from the id field returned by fireflies_transcripts_list. Example: 01HZX2ABCDEF3GHJKMNPQRSTVW

media_type

string

Optional

Whether the bite is a video or an audio clip. Must be video or audio. Leave blank to use Fireflies' default. Example: video. One of: `video`, `audio`.

name

string

Optional

Title for the bite, up to 256 characters. Leave blank to let Fireflies choose the name. Example: Customer agrees to pricing

privacies

array

Optional

Who can see the bite, as a list of one or more of public, team, and participants: public lets anyone with the bite's link open it, team makes it visible to your team members, and participants makes it visible to the meeting's participants. Combine values to allow several groups. Leave blank to use Fireflies' default visibility, which is not documented, so set privacies explicitly whenever who can see the clip matters; an empty list is treated the same as leaving it blank. Example: ["team", "participants"]

summary

string

Optional

Short description of what the bite contains, up to 500 characters. Leave blank to omit it; Fireflies may fill it in. Example: The buyer confirms the annual pricing and asks for a start date.

fireflies_bite_get

Get bite

fireflies_bites_list

List bites

List Fireflies bites, short clips (also called soundbites) cut from meeting recordings, for the owner of the connected API key (mine or my_team) or for one transcript (transcript_id). Returns each bite's id, name, AI summary, summary status, processing status (pending, processing, ready, or error), media type, start and end time, privacies, creation date, transcript_id, creator, source meeting, thumbnail and preview links, and media sources, without caption lines. Page with limit (max 50) and skip. Use this to find bite IDs or to see which clips exist for a meeting. Use fireflies_bite_get for one bite's captions, fireflies_bite_create to clip a new bite, and fireflies_transcripts_list to find transcript IDs. Requires at least one of mine, my_team, or transcript_id; with none of them Fireflies returns the args_required error. Fireflies can answer HTTP 200 with an errors array next to partial data, so use whatever data is present instead of treating the call as failed.

Parameters

Name

Type

Required

Description

limit

integer

Optional

Maximum number of bites to return in one call, up to 50 (Fireflies' documented maximum). Fireflies does not document a default page size, so pass an explicit limit such as 25. Example: 25

mine

boolean

Optional

Set to true to return only the bites that belong to the owner of the connected API key. At least one of mine, my_team, or transcript_id must be provided. Example: true

my_team

boolean

Optional

Set to true to request the my_team result set. Fireflies documents it only as fetching results for the owner of the API key, so how it differs from mine is not specified; use transcript_id when you need every bite of one meeting. At least one of mine, my_team, or transcript_id must be provided. Example: true

skip

integer

Optional

Number of bites to skip before returning results, used with limit for paging. Add the previous limit to the previous skip to get the next page. Use 0 or leave blank for the first page. Example: 25

transcript_id

string

Optional

Return only the bites cut from this transcript (meeting), using the id field from fireflies_transcripts_list. At least one of mine, my_team, or transcript_id must be provided. Example: 01HZX2ABCDEF3GHJKMNPQRSTVW

fireflies_channel_get

Get channel

fireflies_contacts_list

List contacts

fireflies_live_action_item_create

Create live action item

fireflies_live_action_items_list

List live action items

fireflies_live_meeting_add

Add live meeting

Send the Fireflies notetaker bot into a meeting that is in progress, using its meeting link, so the bot joins the call and records and transcribes it. Returns a success flag and a message from Fireflies. This cannot be undone through the API, which has no operation that removes the bot; fireflies_meeting_state_update pauses recording and fireflies_transcript_delete deletes the transcript afterwards. Use this for a call happening now. Use fireflies_audio_upload for a recording that already exists, and fireflies_active_meetings_list to see meetings the Fireflies bot is already in. Rate limited to 3 requests per 20 minutes per user; on Business and Enterprise plans the team shares a pool of 3 requests per paid seat per 20 minutes, up to 60, of which a single user can use at most half (rounded up, never less than 3). Over the limit Fireflies answers too_many_requests with a Retry-After header. The link must be on a platform Fireflies supports (for example Zoom, Google Meet or Microsoft Teams). Fireflies can answer HTTP 200 with an errors array, so read errors before assuming the bot joined and use whatever data is present.

Parameters

Name

Type

Required

Description

meeting_link

string

Required

Full http or https URL that people use to join the meeting the bot should enter, for example a Zoom, Google Meet or Microsoft Teams link. The meeting platform must be one Fireflies supports, otherwise Fireflies answers with an unsupported_platform error. Example: https://meet.google.com/abc-defg-hij

attendees

array

Optional

The people expected to take part in the meeting, as a list. Each attendee can have a displayName (the name shown for that person on the meeting platform, such as Google Meet or Zoom), an email address and a phoneNumber; all three are optional. Omit the whole list if you do not know the participants. Example: [{"displayName": "Dana Lee", "email": "dana@company.com"}, {"displayName": "Sam Ortiz", "phoneNumber": "+14155550123"}]

duration

integer

Optional

Expected length of the meeting in minutes, from 15 to 120. Defaults to 60 minutes if omitted. Example: 45. Default: `60`.

language

string

Optional

Language code of the meeting, so Fireflies transcribes it in the right language. Defaults to English if omitted. Maximum 5 characters; an unrecognized code makes Fireflies answer with an invalid_language_code error. See the Fireflies language codes list for the valid values. Example: en

meeting_password

string

Optional

Password of the meeting, only if the meeting platform requires one to join. Maximum 32 characters. Omit it for meetings without a password. Example: 482915

title

string

Optional

Name of the meeting, used to identify the transcribed file in Fireflies. Maximum 256 characters. If omitted, Fireflies sets a default title automatically. Example: Weekly Pipeline Review

fireflies_meeting_access_revoke

Meeting access revoke

fireflies_meeting_channel_update

Update meeting channel

Move one to five Fireflies meeting transcripts into a single channel; a meeting belongs to only one channel, so this replaces each meeting's previous channel. Returns each updated transcript's id, title, date, duration, host and organizer email, privacy, meeting link, and channels. The order of the results can differ from the order of transcript_ids, so match them by id. Use this to organize meetings into a channel. Use fireflies_channels_list or fireflies_channel_get to find a channel ID, and fireflies_meeting_privacy_update to change a meeting's own access level. The update is all-or-nothing: if any transcript is not found, not accessible, or not permitted, none are moved. The response shows only the new channels, and fireflies_transcripts_list and fireflies_transcript_get do not return a meeting's channel, so the previous channel is not discoverable; Fireflies has no operation to remove a meeting from a channel, so confirm the target channel with the user before moving. Requires transcript IDs from fireflies_transcripts_list and a channel ID from fireflies_channels_list. You need team admin privileges or ownership of every meeting, and all meetings must be owned by users in your team (otherwise Fireflies returns require_elevated_privilege or object_not_found). An empty transcript_ids list, more than 5 IDs, or a missing channel_id returns invalid_arguments. Fireflies can answer HTTP 200 with an errors array next to partial data, so read errors before assuming the change was applied and use whatever data is present.

Parameters

Name

Type

Required

Description

channel_id

string

Required

ID of the single target channel, taken from the id field returned by fireflies_channels_list. Every listed meeting is set to this channel, replacing any channel it had before. Example: 01JABCDEF3GHJKMNPQRSTVWXYZ

transcript_ids

array

Required

IDs of the Fireflies transcripts to move into the channel, from the id field returned by fireflies_transcripts_list. Provide 1 to 5 IDs; an empty list or more than 5 makes Fireflies return invalid_arguments, so split larger sets into several calls. Example: ["01HZX2ABCDEF3GHJKMNPQRSTVW", "01HZX2ABCDEF3GHJKMNPQRSTVX"]

fireflies_meeting_privacy_update

Update meeting privacy

Set the privacy level of one Fireflies meeting transcript, which controls who can access it (anyone with the link, the owner only, participants, teammates, or a combination of teammates and participants). Returns the updated transcript's id, title, new privacy value, date, duration, host and organizer email, participants, meeting link, owner, channels, and the people it is shared with. Use this to widen or restrict access for a whole audience; the link level opens the meeting to anyone who has its link. Use fireflies_meeting_share to give specific people access and fireflies_meeting_access_revoke to remove one shared person. Fireflies does not return the previous level, and fireflies_transcripts_list and fireflies_transcript_get do not show privacy, so restore the old level only if the user told you what it was before the change. Requires a transcript ID from fireflies_transcripts_list and either meeting ownership or team admin privileges, and the meeting owner must be in your team (otherwise Fireflies returns require_elevated_privilege or object_not_found). Fireflies can answer HTTP 200 with an errors array next to partial data, so read errors before assuming the change was applied and use whatever data is present.

Parameters

Name

Type

Required

Description

privacy

string

Required

The privacy level to apply, which decides who can access the meeting. Must be one of: link (anyone with the link can access the meeting), owner (only the meeting owner), participants (only the meeting participants), participatingteammates (only participants who are also teammates; beta, available through the API and MCP only and not yet in the Fireflies dashboard), teammatesandparticipants (teammates and participants), teammates (only teammates). Example: teammates. One of: `link`, `owner`, `participants`, `participatingteammates`, `teammatesandparticipants`, `teammates`.

transcript_id

string

Required

ID of the Fireflies transcript whose privacy level should change, taken from the id field returned by fireflies_transcripts_list. Example: 01HZX2ABCDEF3GHJKMNPQRSTVW

fireflies_meeting_state_update

Update meeting state

fireflies_rule_executions_list

List rule executions

List Fireflies automation rule executions grouped by meeting, optionally filtered by rule, meeting, date range, or test versus production runs. Returns, for each meeting, its meeting_id, title, organizer email, host, attendees, and user group IDs, and the rule runs on it with extension_id (the rule ID), extension_title (the rule name), stopped_at, user_name (the meeting organizer), and the action the rule took (share group_ids, channel_id, or privacy value), plus has_more and next_cursor for paging. Use this to see which automation rules fired on which meetings and what they did. Use fireflies_audit_events_list for who performed manual actions such as sharing or deleting, and fireflies_transcripts_list to find the meetings themselves. Requires an Enterprise plan (otherwise Fireflies returns paid_required). Page meetings with limit (1 to 50) and next_cursor; logs_per_meeting caps the runs returned per meeting (1 to 20). Fireflies can answer HTTP 200 with an errors array next to partial data, so use whatever data is present instead of treating the call as failed.

Parameters

Name

Type

Required

Description

cursor

string

Optional

Paging cursor. Pass the next_cursor value from the previous response to fetch the next page, and keep the same filters. Omit it for the first page. Example: 1705329001000_01K8DV541XM97WMGRCX66TPSWG

date_from

string

Optional

Return only executions from this date, as an ISO 8601 timestamp. Example: 2026-10-01T00:00:00.000Z

date_to

string

Optional

Return only executions up to this date, as an ISO 8601 timestamp. Example: 2026-10-14T23:59:59.000Z

is_test

boolean

Optional

Choose which kind of rule evaluations to return. true returns only test evaluations, false returns only non-test (production) executions, and leaving it empty returns both. Example: false

limit

integer

Optional

Maximum number of meeting groups to return, from 1 to 50. Defaults to 10. Use next_cursor to fetch further pages. Example: 10. Default: `10`.

logs_per_meeting

integer

Optional

Maximum number of rule execution logs to return for each meeting, from 1 to 20. Defaults to 5. Example: 5. Default: `5`.

meeting_id

string

Optional

Return only executions for this meeting, using the same ID as a transcript ID from fireflies_transcripts_list. Example: 01HZX2ABCDEF3GHJKMNPQRSTVW

rule_id

string

Optional

Return only executions of this automation rule. Rule IDs appear as extension_id in this tool's own results. Example: 01JB4XK2M9QZ7R3T5V8W0YABCD

fireflies_transcript_delete

Delete transcript

fireflies_transcript_get

Get transcript

fireflies_transcripts_list

List transcripts

fireflies_user_group_member_add

Add user group member

fireflies_user_group_member_remove

Remove user group member

fireflies_user_groups_list

List user groups

fireflies_user_role_set

Set user role

For more tools, view docs.

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// Fireflies tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["fireflies"], toolNames: [
    "fireflies_transcripts_list",
    "fireflies_transcript_get",
    "fireflies_askfred_thread_create"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "Summarize what we committed to in yesterday's call with Acme" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["fireflies"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Summarize what we committed to in yesterday's call with Acme" }],
  tools,
});

// Execute the tool call with the user's vaulted Fireflies access token
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["fireflies"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Summarize what we committed to in yesterday's call with Acme" }],
  tools,
});

// Tool call runs with the user's vaulted Fireflies access token
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["fireflies"] }, pageSize: 100,
});

const agent = new Agent({
  name: "meeting_agent",
  model: "gemini-2.5-pro",
  instruction: "Fireflies tools scoped to this user",
  tools,
});

await agent.run("Summarize what we committed to in yesterday's call with Acme");

Try these prompts

Copy any prompt into your agent. Each maps directly to a Fireflies tool. Click to copy, paste into your agent, done.

Transcripts

Copy the prompt

Copied

List my meetings from last week that mention pricing.

Copy the prompt

Copied

Summarize the transcript of yesterday's Acme call.

Copy the prompt

Copied

Upload this recording URL for transcription with the title Customer Webinar.

AskFred and bites

Copy the prompt

Copied

Ask Fred what objections came up in this week's sales calls.

Copy the prompt

Copied

Create a bite from minute 12 to minute 14 of this meeting.

Copy the prompt

Copied

Continue this AskFred thread and ask for the next steps.

Live meetings and sharing

Copy the prompt

Copied

Send the Fireflies notetaker into this meeting link.

Copy the prompt

Copied

Pause recording in the meeting the bot is in now.

Copy the prompt

Copied

Share this transcript with jane@acme.com.

SEE HOW AUTH WORKS

Each user connects their own Fireflies access token once, and Scalekit sends it with every call. Tokens stay vaulted, every call is scope checked, and every action is logged.

Authorize

Your user connects

Fireflies

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

Fireflies

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

Fireflies

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

Fireflies

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other transcription and productivity connectors.

Support and Ops Teams

Meeting prep

Pulls agenda, participant context, and open action items before every meeting.

GTM and RevOps Teams

Sales call prep agent

Reads tomorrow's calls from Google Calendar, mines past Granola notes and Attio history for context, and delivers each rep a prep brief in Slack, scoped to the calls that rep actually owns.

GTM and RevOps Teams

Deal intelligence agent

Pulls recent Gong calls, scores deal risk with an LLM, cross-references the record in Attio, and DMs each owner their at-risk deals in Slack. Every read is scoped to that rep's own access.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared Fireflies access token looks fine in a demo. In production every share and transcript change looks like one service account, and you cannot tell which user triggered it. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared token
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

Fireflies today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access Fireflies as the user or through a shared token?

As the user. Each user connects their own Fireflies access token once, and Scalekit sends it with every call. Audit logs attribute every share, upload, and transcript change to that user, not a shared service account.

Where is the Fireflies access token stored?

In Scalekit's managed AES-256 token vault, namespaced per tenant. To rotate it, the user reconnects with a new access token. Revocation is a single dashboard action. Credentials never appear in prompts, logs, or LLM context.

Can I limit what the agent does in Fireflies?

Yes. Filter by tool name in listScopedTools to expose only what you want, for example the transcript and AskFred tools without fireflies_transcript_delete, which removes a meeting transcript from Fireflies. Scalekit also enforces scope checks before every API call.

What happens when a user revokes Fireflies access?

The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Can the agent join meetings that are already in progress?

Yes. fireflies_live_meeting_add sends the Fireflies notetaker into a live meeting by its link. While the bot is in the call, fireflies_meeting_state_update pauses or resumes recording, and fireflies_live_action_items_list reads the action items captured so far.