fireflies

name	fireflies
description	Query Fireflies.ai meeting transcripts, meeting notes, summaries, contacts, channels, AI meeting analytics, AskFred, audio uploads, and webhook signatures through its GraphQL API. Use when a user mentions Fireflies, Fireflies.ai, meeting transcripts or notes stored in Fireflies, AskFred, or Fireflies webhooks. Do not use for local audio transcription, calendar management, or meetings that are not Fireflies data.
license	MIT
compatibility	Requires Python 3.9+, network access for API calls, and FIREFLIES_API_KEY for non-dry-run API requests.
metadata	{"service":"fireflies.ai","api":"graphql"}
allowed-tools	Bash Read

Fireflies.ai

Use scripts/fireflies from this skill directory. It uses the Fireflies GraphQL endpoint directly and emits the API response as JSON. Read-only discovery is safe. Before any state change, confirm the target, scope, and rollback path; then route the change through the CLI's literal --confirm. --dry-run previews a payload only and never authorizes a write.

First Use

1. Check the command schema: scripts/fireflies --help and the relevant subcommand help.
2. Set FIREFLIES_API_KEY only for an actual API request. Do not expose or persist it.
3. Start with read-only discovery, such as scripts/fireflies transcripts list --limit 10 --json.
4. Use --dry-run --json before each mutation to inspect the exact GraphQL payload.

Command Map

Need	Command
Find transcript metadata	scripts/fireflies transcripts list --keyword TEXT --limit 10 --json
Read a meeting, summary, sentences, analytics, and recording links	scripts/fireflies transcripts get ID --json
People, channels, groups, contacts, apps	users, channels, groups, contacts, apps
Meeting analytics or live meetings	analytics --start DATE --end DATE, meetings active
Ask a transcript question	askfred create --question TEXT --transcript-id ID --confirm
Read one AskFred thread	askfred get THREAD_ID
Assign an admin/user role	users set-role --user-id ID --role admin --confirm
Move meetings into a channel	meetings update-channel --channel-id ID --transcript-ids A,B,C --confirm
Add a live meeting by link	live add-to --meeting-link URL --confirm
Create a soundbite clip	live soundbite --meeting-id ID --prompt TEXT --confirm
Two-phase file upload	audio create-upload ... --confirm then audio confirm-upload --meeting-id ID --confirm
Run an exact current/future API operation	query --document GRAPHQL --variables JSON
Verify a delivered webhook locally	webhook verify --secret SECRET --signature sha256=... --body FILE

Safe Mutation Workflow

1. Identify the Fireflies object ID and present the intended change.
2. Confirm target, scope, and rollback path with the user. Deletion may not be reversible.
3. Preview the exact document using --dry-run; this makes no HTTP request.
4. Run exactly the approved mutation with --confirm.
5. Return the response without printing credentials.

Examples:

scripts/fireflies meetings rename transcript-id --title "Weekly product review" --dry-run --json
scripts/fireflies meetings rename transcript-id --title "Weekly product review" --confirm --json
scripts/fireflies transcripts delete transcript-id --confirm --json

Reference Routing

• Read references/cli-reference.md for syntax, output, exit codes, or generic GraphQL execution.
• Read references/api-reference.md for the API model, exact documented operation families, limits, permissions, and source links.
• Read references/workflows.md for transcript, analytics, upload, AskFred, and generic-operation recipes.
• Read references/webhook-security.md when receiving or implementing Webhooks V2.
• Read references/troubleshooting.md after an auth, GraphQL, limit, permission, pagination, or webhook failure.
• Read references/source-index.md when validating source scope or documentation freshness.

Boundaries

The CLI never starts a webhook server, stores API keys, or guesses undocumented GraphQL fields. If an ergonomic command does not cover the needed current operation, use query or mutation with a documented GraphQL document. The generic mutation command still requires --confirm.