fireflies
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.
How do I install this agent skill?
npx skills add https://github.com/magnus919/agent-skills --skill firefliesIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The Fireflies meeting intelligence skill provides a secure, dependency-free Python CLI for interacting with the Fireflies.ai GraphQL API. It implements best practices for secret management, uses standard libraries, and includes safety mechanisms like dry-run previews and explicit confirmation for mutations. The skill operates within a well-defined scope to manage meeting transcripts and analytics.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
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 --helpand the relevant subcommand help. - Set
FIREFLIES_API_KEYonly 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 --jsonbefore 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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/magnus919/agent-skills/fireflies">View fireflies on skillZs</a>