ffcli — Fireflies.ai CLI
Query meeting recordings, transcripts, and AI summaries from Fireflies.ai.
Setup
Install via Homebrew or npm:
brew install ruigomeseu/tap/ffcli
# or
npm install -g @ruigomeseu/ffcli
Authenticate with your Fireflies API key (get it from Settings → Developer Settings):
ffcli auth <your-api-key> # Store key locally (~/.config/ffcli/)
ffcli auth --check # Verify it works
Alternatively, set the FIREFLIES_API_KEY environment variable (takes precedence over stored config). In OpenClaw, configure it via skills.entries.ffcli.apiKey in openclaw.json.
Note: ffcli is a third-party CLI by @ruigomeseu (Homebrew tap or npm). Verify the source before installing: check the npm package or Homebrew tap repo for code review and publish history.
Commands
List meetings
ffcli list --limit 10 --md # Recent meetings
ffcli list --from 2026-02-01 --to 2026-02-12 --md # Date range
ffcli list --participant vinney@opennode.com --md # By participant
ffcli list --search "standup" --md # By title keyword
ffcli list --limit 5 --include-summaries # With AI summaries (JSON)
Show meeting detail
ffcli show <id> --md # Full detail (markdown)
ffcli show <id> --summary-only --md # Just AI summary
ffcli show <id> --transcript-only --md # Just transcript
ffcli show <id> --include-transcript --md # Detail + transcript
User info
ffcli me --md # Account info, transcript count
Scripting patterns
# Action items from recent meetings
ffcli list --limit 10 --include-summaries | jq '.[].summary.action_items'
# All meeting IDs from a date range
ffcli list --from 2026-02-01 --to 2026-02-07 | jq -r '.[].id'
# Export a summary to file
ffcli show <id> --summary-only --md > meeting-summary.md
Notes
- Default output is JSON. Use
--mdfor readable output. --include-summariesonlistadds AI summaries (increases response size).- Meeting IDs are needed for
show— get them fromlistfirst. - Dates are UTC in JSON output.
