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 --md for readable output.
• --include-summaries on list adds AI summaries (increases response size).
• Meeting IDs are needed for show — get them from list first.
• Dates are UTC in JSON output.