@firefliesai/n8n-nodes-fireflies/README.md

An n8n integration for the Fireflies.ai API that enables workflow automation with meeting transcripts, analytics, summaries, and other conversation data from Fireflies.ai's AI meeting assistant.

# n8n-nodes-fireflies

This is an n8n community node. It lets you use Fireflies.ai in your n8n workflows.

Fireflies is an AI meeting assistant that automatically records, transcribes, and analyzes your meetings. It integrates with popular video conferencing platforms to help teams capture and search through important meeting content.

[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

[Installation](#installation)  
[Operations](#operations)
[Usage](#usage)
[Credentials](#credentials)  
[Resources](#resources)  
[Version history](#version-history)

## Installation

Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

## Operations

The **Fireflies** node supports the following operations for interacting with the [Fireflies.ai API](https://docs.fireflies.ai):

- **Get AI App Outputs**  
  Retrieve results generated by AI applications installed in your Fireflies workspace.

- **Get Current User**  
  Fetch the profile details of the user associated with the provided API key.

- **Get Transcript Analytics**  
  Access AI-driven analytics such as sentiment, topics, and engagement data for a specific meeting transcript.

- **Get Transcript Summary**  
  Retrieve a concise, AI-generated summary of a meeting, including bullet points, action items, and key highlights.

- **Get Transcript**  
  Get the full transcript of a specific meeting using its unique identifier.

- **Get Transcripts List**  
  Fetch a paginated list of available meeting transcripts. Supports advanced filtering by email, date, and user ID.

- **Get Users**  
  Retrieve a list of users within your Fireflies organization, including metadata like names and emails.

- **Upload Audio**  
  Upload audio recordings for transcription. This is useful for meetings, interviews, or any spoken content you want transcribed.

---

## Usage

### Fetching and Chaining Transcripts

The **Get Transcripts List** operation retrieves a list of available meeting transcripts based on optional filters such as:

- `organizer_email`
- `participant_email`
- `host_email`
- `title`
- `user_id`
- `from_date` / `to_date`

This is often the first step in building a workflow, allowing you to dynamically retrieve and iterate over multiple transcript records.

Once you have the transcript IDs from this operation, you can pass them as inputs to the following operations:

- **Get Transcript**: Fetch the full transcript content.
- **Get Transcript Summary**: Retrieve [summary](https://docs.fireflies.ai/schema/summary) and key takeaways.
- **Get Transcript Analytics**: Access [analytics](https://docs.fireflies.ai/schema/analytics) like sentiment, topic extraction, and more.

These operations can be chained together to create rich workflows for reporting, insights, or downstream automation.

📘 For a full reference of transcript fields and response structure, see the [Fireflies Transcript Schema](https://docs.fireflies.ai/schema/transcript).

## Credentials

To use the Fireflies node, you need to authenticate with your Fireflies API key.

1. Log in to your [Fireflies.ai](https://fireflies.ai) account
2. Go to Settings > Developer Settings
3. Generate or copy your existing API key
4. Use this API key in your n8n credentials for the Fireflies node

The node uses API Key authentication to securely connect to the Fireflies.ai API.

## Resources

- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
- [Fireflies.ai API documentation](https://docs.fireflies.ai)

## Version history

### 1.0.7

- Fixed nodeParameter handling for all operations

### 1.0.6

- Removed unsupported field from getAiAppOutput operation

### 1.0.5

- Fixes bug in handling input data

### 1.0.4

- Major refactor to separate code into resources and operations

### 1.0.3

- Bump version due to inconsistent build

### 1.0.2

- Refactored Fireflies Node implementation
- Replaced axios with http helper
- Added test for credentials

### 1.0.1

- Fixed bugs in array responses

### 1.0.0

- Added operations Get AI App Outputs, Get Meeting Analytics, Get Meeting Summary, Get Transcript, Get Transcripts List, Get Users, and Upload Audio
- Initial release of the Fireflies.ai node for n8n