> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Give AI Agents Access to Fireflies Transcripts

> Let agents read Fireflies transcripts, summaries, and action items through the GraphQL API and MCP server, with your API key injected by the gateway.

## Overview

Buckle connects AI agents to [Fireflies](https://fireflies.ai) with an API key. Agents can search meetings and read transcripts, summaries, and action items. The gateway injects the key into every request, so your agent never sees it.

Connecting takes about a minute.

## What you will set up

* A Fireflies API key stored in Buckle
* Automatic key injection on GraphQL and MCP requests
* Per-agent access, with queries allowed and mutations behind approval

## Connect Fireflies

**1. Copy your API key from Fireflies**

In Fireflies, open [Integrations > Fireflies API](https://app.fireflies.ai/integrations/custom/fireflies) and copy your API key.

**2. Paste it in Buckle**

In the Buckle dashboard, open **Settings** > **Apps** > **Fireflies**, paste the key into **API Key**, and click **Connect Fireflies**.

![Buckle connect window for Fireflies, showing the setup guide link, the API Key field, and the Connect Fireflies button.](https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/fireflies/buckle-connect-fireflies.png?fit=max\&auto=format\&n=hJP3XqgFsBDnXHKy\&q=85\&s=8c2e851c94e038b68a12ac32f902c09c)

The Fireflies connect window in Buckle.

> [!NOTE]
>
> The key has the same access as your Fireflies account. Treat it like a password.

## What agents can do

| Area | What agents can do |
| - | - |
| **Read** | Query meetings, transcripts, summaries, and action items through the GraphQL API |
| **Write** | Run GraphQL mutations, and use the Fireflies MCP server |

## Controlling access

[Grant](/docs/guides/agent-access.md) the connection to each agent that needs it, and choose per tool what runs freely, what needs approval, and what's blocked. Allow **GraphQL API (queries)** for reading, and put **mutations** and the **MCP server** behind approval. Organization [rules](/docs/guides/rules.md) add guardrails on top. A blocked request never reaches Fireflies.

To disconnect, remove the connection in **Settings** > **Apps** > **Fireflies**, then regenerate the key in Fireflies under **Integrations** > **Fireflies API**.

## FAQ

> [accordion] How do I rotate my Fireflies API key?
>
> Regenerate the key in Fireflies under **Integrations** > **Fireflies API**, then paste the new key into **Settings** > **Apps** > **Fireflies**. Agents pick it up automatically.

> [accordion] How do I keep the key out of the agent's context?
>
> Store it in Buckle. The gateway injects it at the proxy, so the agent never holds a key with your full Fireflies access. See [How it works](/docs/how-it-works.md).

> [accordion] Can agents read without running mutations?
>
> Yes. Allow **GraphQL API (queries)** and put mutations behind approval when you [grant](/docs/guides/agent-access.md) the connection.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.