# Fireflies MCP

Connect Fireflies to access meeting transcripts, summaries, and insights.

---

Connect your Fireflies account to give your AVCodex agent access to meeting transcripts, summaries, and conversation details. Useful for any AV team running design reviews, kickoffs, RFP debriefs, or client check-ins.

## Overview

The Fireflies integration lets your agent:

- **Get transcripts** - fetch a list of recent meeting transcripts.
- **Get summary** - retrieve AI-generated summaries for a specific meeting.
- **Get sentences** - access the full transcript content with speaker labels.

## Prerequisites

- A [Fireflies.ai](https://fireflies.ai) account.
- A Fireflies API key.
- A Builder plan or higher on AVCodex.

## Get your Fireflies API key

1. Go to [Fireflies Settings](https://app.fireflies.ai/settings).
2. Click **Developer Settings** in the sidebar.
3. Copy your **API Key**.

> **Note:** Keep your API key secure. Never share it publicly or commit it to version control.

## Connect Fireflies to AVCodex

1. Go to [app.avcodex.com](https://app.avcodex.com) and open your agent.
2. Click **Build** in the sidebar.
3. Scroll to the **Connect** card.
4. Click **Add Pro Action**.
5. Find **Fireflies** in the integration list.
6. Paste your API key.
7. Click **Save**.

Once connected, you can enable the following tools:

- **Get Transcripts** - list recent meeting transcripts.
- **Get Summary** - get AI-generated meeting summaries.
- **Get Sentences** - access full transcript text.

## Available tools

### Get transcripts

Fetches a list of your recent transcripts from Fireflies.

**Parameters**

- `limit` (optional): number of transcripts to fetch (default: 10).

**Returns:** list of transcripts with title, date, and ID.

**Example**

```
User: "Show me my recent meeting transcripts"

Agent: Here are your recent transcripts:

Title: Q4 Planning Meeting
Date: 12/10/2025
ID: abc123

---

Title: Acme Corp - 14F boardroom design review
Date: 12/9/2025
ID: def456
```

### Get summary

Retrieves the AI-generated summary for a specific transcript.

**Parameters**

- `transcriptId` (required): the ID of the transcript.

**Returns:** meeting summary with key points, action items, and decisions.

**Example**

```
User: "Get the summary for the Q4 Planning meeting"

Agent: Here's the summary:

Key Points:
- Agreed Q4 revenue targets for the dealer program.
- Field-tech headcount approved for two more hires.
- Q-SYS Reflect rollout scheduled for November.

Action Items:
- Sarah: finalize the dealer program comms by Friday.
- John: review project margins on the 1200 Market refresh.
- Team: weekly sync every Monday.
```

### Get sentences

Retrieves the full transcript with speaker labels and timestamps.

**Parameters**

- `transcriptId` (required): the ID of the transcript.

**Returns:** full conversation text with speaker attribution.

**Example**

```
User: "Show me what was said in the Acme design review"

Agent: Here's the transcript:

Sarah (00:00): Thanks for joining today's design review...
John (00:15): Happy to be here. Let's walk the rack elevation...
```

## Example workflows

### Meeting recap assistant

**System prompt**

```
You help techs and PMs catch up on meetings they missed. When asked
about a meeting, search Fireflies transcripts to find it, then provide
a summary and action items.
```

**User interaction**

```
User: "What did I miss in yesterday's commissioning standup?"

Agent: Let me check your recent transcripts...

[Calls: Get Transcripts]
[Calls: Get Summary for the standup transcript]

Yesterday's standup covered:
- Boardroom 4 commissioning is on track (70% complete).
- Blocker: waiting on a Biamp Tesira firmware update.
- Action item: you were assigned to follow up with the manufacturer.
```

### Client call notes

**System prompt**

```
You help account managers review client calls. Find transcripts for
specific clients and highlight discussion points, objections, and
next steps.
```

**User interaction**

```
User: "What did we discuss with Acme Corp last week?"

Agent: [Calls: Get Transcripts with limit 20]
[Calls: Get Summary for the Acme transcript]

Your call with Acme covered:
- They're interested in extending the managed-services contract.
- Main concern: ceiling-mic gate thresholds in the 14F boardroom.
- Next step: you agreed to send a tuning plan and revised SOW.
- Follow-up scheduled for next Thursday.
```

## Best practices

**Start with summaries.** Use Get Summary for quick insights before pulling the full transcript.

**Combine with search.** Ask the agent to find specific topics across multiple transcripts (for example, every mention of a Crestron firmware version or a Biamp DSP issue).

**Cache frequently accessed data.** The integration caches results to reduce API calls.

**Be patient with long meetings.** Long design reviews can take a moment to process.

## Troubleshooting

### "Authentication failed"

- Verify your API key is correct.
- Confirm you copied the entire key from Developer Settings.
- Try generating a new API key in Fireflies.

### No transcripts found

- Ensure you have recordings in your Fireflies account.
- Check that transcription completed for recent meetings.
- Verify you're using an account with transcripts (not a team member without access).

### Rate limit errors

- The integration automatically queues requests when rate limits are reached.
- Wait a moment and the request will retry.
- Reduce the number of transcripts requested at once.

## Get help

- Email support@avcodex.com.

*AVCodex · Your AV expertise. Amplified by AI.*