Fireflies.ai Integration

DevBoy tools provides integration with Fireflies.ai for accessing meeting transcripts, summaries, and action items through AI assistants. This is the first provider in the MeetingNotes category.

Authentication

Fireflies uses a simple API key for authentication:

Auth MethodToken Source
Bearer Token (API Key)Fireflies API Settings

Configuration

Basic configuration

# Store Fireflies API key in OS keychain
devboy config set-secret fireflies.token <your-api-key>

Configuration file

Settings are stored in ~/.config/devboy-tools/config.toml:

[fireflies]
# API key is stored in the OS keychain, not in the config file

Environment variables

export DEVBOY_FIREFLIES_TOKEN=your-api-key

Available Tools

get_meeting_notes

List meeting notes with optional filters.

ParameterTypeDescription
from_datestringFilter from date (ISO 8601)
to_datestringFilter to date (ISO 8601)
participantsstring[]Filter by participant emails
host_emailstringFilter by host email
limitintegerMax results (default: 50, max: 50)
offsetintegerSkip N results

Example:

get_meeting_notes from_date="2025-01-01T00:00:00Z" limit=10

get_meeting_transcript

Get the full transcript for a meeting with speaker-attributed, timestamped sentences.

ParameterTypeRequiredDescription
meeting_idstringYesMeeting ID from get_meeting_notes

Example output:

# Sprint Planning

Showing 45 sentences

[00:00] Alice: Let's discuss the sprint goals.
[00:15] Bob: I think we should focus on the API migration.
[01:30] Alice: Agreed. What about the timeline?

search_meeting_notes

Search across meetings by keywords, topics, or action items.

ParameterTypeRequiredDescription
querystringYesSearch keyword
from_datestringNoFilter from date
to_datestringNoFilter to date
participantsstring[]NoFilter by participant emails
host_emailstringNoFilter by host email
limitintegerNoMax results (default: 50)
offsetintegerNoSkip N results

Example:

search_meeting_notes query="database migration"

Use Cases

  1. Task Context — When picking up a task, read meeting transcripts where requirements were discussed.
  2. Action Item Tracking — Cross-reference meeting action items with open issues.
  3. Decision Archaeology — Search past meetings to understand why technical decisions were made.

API Reference

  • Endpoint: https://api.fireflies.ai/graphql
  • Protocol: GraphQL
  • Rate Limits: Standard API rate limits apply
  • Documentation: Fireflies GraphQL API