| 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
- Check the command schema:
scripts/fireflies --help and the relevant subcommand help.
- Set
FIREFLIES_API_KEY only for an actual API request. Do not expose or persist it.
- Start with read-only discovery, such as
scripts/fireflies transcripts list --limit 10 --json.
- 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
- Identify the Fireflies object ID and present the intended change.
- Confirm target, scope, and rollback path with the user. Deletion may not be reversible.
- Preview the exact document using
--dry-run; this makes no HTTP request.
- Run exactly the approved mutation with
--confirm.
- 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.
