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 <n>(default 14),--limit <n>(default 50) - transcript — Full transcript with timestamps. Requires
--id <meeting_id> - summary — Meeting summary, overview, and action items. Requires
--id <meeting_id> - search — Search by keyword in titles/content. Requires
--keyword <text>, optional--limit <n>
Workflow
- Use
listto find meetings and get IDs - Use
summaryortranscriptwith the ID to get details - Use
searchto 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