fireflies-api

TypeScript SDK for Fireflies.ai with realtime transcription streaming.

Disclaimer: This is an unofficial, community-built open source SDK. It is NOT affiliated with, endorsed by, or associated with Fireflies.ai Inc. This project provides a TypeScript SDK and CLI that uses the publicly available Fireflies API.

Features

• Full GraphQL API coverage
• Live transcription streaming via Socket.IO (key differentiator)
• Auto-pagination for large datasets
• TypeScript-first with full type coverage
• Works with Node.js 18+ and Bun

Quick Start

npm install fireflies-api

import { FirefliesClient } from 'fireflies-api';

const client = new FirefliesClient({
  apiKey: process.env.FIREFLIES_API_KEY!,
});

// List recent transcripts
const transcripts = await client.transcripts.list({ limit: 10 });

for (const t of transcripts) {
  console.log(`${t.title} - ${t.date}`);
}

Realtime Transcription

Stream live transcription from an active meeting:

for await (const chunk of client.realtime.stream('meeting-id')) {
  console.log(`${chunk.speaker_name}: ${chunk.text}`);
}

Documentation

• Getting Started - Installation and configuration
• Transcripts - Query and manage transcripts
• Realtime Streaming - Live transcription
• Users & Teams - User management
• Bites - Clips and soundbites
• Meetings - Active meetings and bot management
• Audio Upload - Upload audio for transcription
• AI Apps - AI application outputs
• Pagination - Auto-pagination patterns
• Error Handling - Error types and recovery
• Migration Guide - Migrating from official SDK

API Reference

For Fireflies API field details, see docs.fireflies.ai.

Claude Code Plugin

Use Fireflies directly in Claude Code with slash commands:

# Install the plugin
/plugin marketplace add BjoernSchotte/fireflies-api
/plugin install fireflies@fireflies-api

Set your API key before launching Claude Code:

export FIREFLIES_API_KEY="your-api-key"
claude

Available commands:

• /ff-transcripts - List, get, analyze transcripts
• /ff-search - Full-text search
• /ff-insights - Meeting analytics
• /ff-meetings - Active meetings, add bot
• /ff-realtime - Live transcription streaming
• /ff-export - Export to markdown/JSON

See Claude Code Plugin docs for full documentation.

License

MIT