fireflies-ai

# 🔥 Fireflies AI

Query your Fireflies.ai meeting data directly — transcripts, summaries, action items, contacts, and analytics. Zero storage: all data stays on Fireflies servers.

## Features

- **Search meetings** by keyword, date range, host, or participant
- **Get full transcripts** with speaker-attributed sentences
- **Extract action items** and meeting summaries
- **Meeting analytics** — sentiment, speaker stats, talk time
- **Contact lookup** — see who you've met with
- **User info** — account details and team members

## Requirements

| Variable | Required | Description |
|----------|----------|-------------|
| `FIREFLIES_API_KEY` | ✅ | API key from [app.fireflies.ai/integrations](https://app.fireflies.ai/integrations/custom/fireflies) |

## Quick Start

```bash
# List recent meetings
python3 {baseDir}/scripts/fireflies.py meetings --limit 10

# Search meetings by keyword (searches titles and spoken words)
python3 {baseDir}/scripts/fireflies.py search "quarterly review"

# Search within specific date range
python3 {baseDir}/scripts/fireflies.py meetings --from 2026-01-01 --to 2026-02-01

# Filter by participant email
python3 {baseDir}/scripts/fireflies.py meetings --participant "john@example.com"

# Filter by host email
python3 {baseDir}/scripts/fireflies.py meetings --host "jane@example.com"

# Get full transcript for a meeting
python3 {baseDir}/scripts/fireflies.py transcript <meeting_id>

# Get summary only
python3 {baseDir}/scripts/fireflies.py summary <meeting_id>

# Get action items only
python3 {baseDir}/scripts/fireflies.py actions <meeting_id>

# Get meeting analytics (sentiment, speaker stats)
python3 {baseDir}/scripts/fireflies.py analytics <meeting_id>

# Get attendee info for a meeting
python3 {baseDir}/scripts/fireflies.py attendees <meeting_id>

# List all contacts
python3 {baseDir}/scripts/fireflies.py contacts

# Get current user info
python3 {baseDir}/scripts/fireflies.py user

# Get team members
python3 {baseDir}/scripts/fireflies.py use...