Fireflies MCP server

This MCP server acts as an integration layer between Claude and Fireflies.ai, allowing you to retrieve and search meeting transcripts, access detailed transcript information, and generate meeting summaries. The server provides tools for managing and analyzing your meeting data through structured API calls.

Installation and Setup

Prerequisites

You'll need a Fireflies API key before setting up the server:

1. Go to the Fireflies.ai dashboard
2. Navigate to Settings > API
3. Generate a new API key
4. Copy the generated key

Installing the Server

There are two main ways to use this MCP server:

Method 1: Using npx (Recommended for Claude Desktop)

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "fireflies": {
      "command": "npx",
      "args": [
        "-y",
        "@props-labs/mcp/fireflies"
      ],
      "env": {
        "FIREFLIES_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Replace <YOUR_API_KEY> with your actual Fireflies API key.

Method 2: Manual Installation

1. Clone the repository
2. Install dependencies:

npm install
# or
pnpm install

3. Build the project:

npm run build
# or
pnpm build

4. Start the server:

FIREFLIES_API_KEY=your_api_key npm start
# or
FIREFLIES_API_KEY=your_api_key pnpm start

You can also use the included setup script:

./setup.sh
FIREFLIES_API_KEY=your_api_key npm start

Using the MCP Tools

The Fireflies MCP server provides four main tools:

Retrieving Transcripts

Use fireflies_get_transcripts to fetch a list of meeting transcripts:

Inputs:
- limit (optional number): Maximum number of transcripts to return
- from_date (optional string): Start date in ISO format (YYYY-MM-DD)
- to_date (optional string): End date in ISO format (YYYY-MM-DD)

Example usage:

// Get the 10 most recent transcripts
fireflies_get_transcripts(10)

// Get transcripts from a specific date range
fireflies_get_transcripts(20, "2023-01-01", "2023-01-31")

Getting Transcript Details

Use fireflies_get_transcript_details to access comprehensive information about a specific transcript:

Inputs:
- transcript_id (string): ID of the transcript to retrieve

Example usage:

// Get detailed information for a specific transcript
fireflies_get_transcript_details("abc123xyz")

Searching Transcripts

Use fireflies_search_transcripts to find transcripts containing specific keywords:

Inputs:
- query (string): Search query to find relevant transcripts
- limit (optional number): Maximum number of transcripts to return

Example usage:

// Search for transcripts mentioning "budget planning"
fireflies_search_transcripts("budget planning", 5)

Generating Summaries

Use fireflies_generate_summary to create concise summaries of meeting transcripts:

Inputs:
- transcript_id (string): ID of the transcript to summarize
- format (optional string): Format of the summary ('bullet_points' or 'paragraph')

Example usage:

// Generate a bullet-point summary
fireflies_generate_summary("abc123xyz", "bullet_points")

// Generate a paragraph summary
fireflies_generate_summary("abc123xyz", "paragraph")

Each tool returns structured data about the transcripts, which can be used for further analysis or display in Claude.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "fireflies" '{"command":"npx","args":["-y","@props-labs/mcp/fireflies"],"env":{"FIREFLIES_API_KEY":"<YOUR_API_KEY>"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "fireflies": {
            "command": "npx",
            "args": [
                "-y",
                "@props-labs/mcp/fireflies"
            ],
            "env": {
                "FIREFLIES_API_KEY": "<YOUR_API_KEY>"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "fireflies": {
            "command": "npx",
            "args": [
                "-y",
                "@props-labs/mcp/fireflies"
            ],
            "env": {
                "FIREFLIES_API_KEY": "<YOUR_API_KEY>"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect