Fireflies Insights
Aggregate meeting analytics and statistics.
Command
npm exec --yes --package=fireflies-api -- fireflies-api insights [options]
Options
Date Shortcuts (prefer these over --from/--to):
--today - Today's meetings--yesterday - Yesterday's meetings--last-week - Last 7 days--last-month - Last 30 days--days <n> - Last N days
Analytics Options:
--external - Include external participants--speaker <name> - Filter by speaker--group-by <field> - Group results by field--top <n> - Show top N results--from <date> - Start date (YYYY-MM-DD) - only if shortcuts don't fit--to <date> - End date (YYYY-MM-DD) - only if shortcuts don't fit-o, --output <format> - Output format: json, jsonl, table, tsv, plain
Examples
# Get insights for last week
npm exec --yes --package=fireflies-api -- fireflies-api insights --last-week
# Get insights grouped by speaker
npm exec --yes --package=fireflies-api -- fireflies-api insights --last-month --group-by speaker
# Get top 5 speakers
npm exec --yes --package=fireflies-api -- fireflies-api insights --days 30 --top 5
# Get insights for specific date range
npm exec --yes --package=fireflies-api -- fireflies-api insights --from 2024-01-01 --to 2024-01-31
Instructions
Verify API key is set:
test -n "$FIREFLIES_API_KEY" && echo "Ready" || echo "ERROR: Set FIREFLIES_API_KEY"
Execute the insights command with appropriate date filters.
Suggest grouping options for better analysis (by speaker, by date, etc.).
Usage Tips
Output Format:
- Use
-o plain for detailed human-readable output
- Use
-o table for compact summary
- Only use
-o json if user needs structured data
When to Use Insights:
- Getting meeting statistics and trends (efficient - single call)
- Speaker analytics across multiple meetings
- Time-based analysis (by day, week, month)
- Meetings with external participants - use
--external flag (filters by domain)
- Avoids N+1 queries - aggregates in one API call
