Firefly AI Integration

Pull meeting data from Firefly AI via their GraphQL API.

Setup

Requires FIREFLY_API_KEY environment variable. Store in gateway env config.

Usage

Run the script at scripts/firefly.cjs with Node.js:

FIREFLY_API_KEY=<key> node scripts/firefly.cjs <command> [options]

Commands

• list — List recent meetings. Options: --days (default 14), --limit (default 50)
• transcript — Full transcript with timestamps. Requires --id
• summary — Meeting summary, overview, and action items. Requires --id
• search — Search by keyword in titles/content. Requires --keyword , optional --limit

Workflow

• Use list to find meetings and get IDs
• Use summary or transcript with the ID to get details
• Use search to find meetings by topic

For custom queries

Build GraphQL queries directly against https://api.fireflies.ai/graphql. See references/api.md for full schema and available fields.

Large transcripts

Full transcripts can be very long (2000+ sentences). When a user asks for a transcript:

• Save to a file in the workspace if they want to keep it
• Summarize or extract relevant sections if they want specific info
• Show a preview (first ~50 lines) and ask if they want more