Fireflies MCP

🚀 Fireflies MCP Server

The MCP server provided for the Fireflies.ai API, enabling functions such as transcription record retrieval, search, and summary generation.

🚀 Quick Start

The Fireflies MCP Server is designed to offer transcription record retrieval, search, and summary generation functions for the Fireflies.ai API.

✨ Features

• Transcription Management: Retrieve and search meeting transcription records with support for filtering options.
• Detailed Information: Obtain comprehensive information about specific transcription records.
• Advanced Search: Find transcription records containing specific keywords or phrases.
• Summary Generation: Generate concise summaries of meeting transcription records and support output in multiple formats.

📦 Tools

1. fireflies_get_transcripts

• Retrieve a list of meeting transcription records with optional filtering conditions.
• Input Parameters:
  • limit (optional number): The maximum number of transcription records to return.
  • from_date (optional string): The start date in ISO format (YYYY - MM - DD).
  • to_date (optional string): The end date in ISO format (YYYY - MM - DD).
• Return Result: An array of transcription record objects containing basic information.

2. fireflies_get_transcript_details

• Get detailed information about a specific transcription record.
• Input Parameters:
  • transcript_id (string): The ID of the transcription record to retrieve.
• Return Result: Comprehensive transcription record details, including speakers, content, and metadata.

3. fireflies_search_transcripts

• Search for transcription records containing specific keywords.
• Input Parameters:
  • query (string): The search term used to find relevant transcription records.
  • limit (optional number): The maximum number of transcription records to return.
• Return Result: An array of matching transcription record objects.

4. fireflies_generate_summary

• Generate a summary of a meeting transcription record.
• Input Parameters:
  • transcript_id (string): The ID of the transcription record to summarize.
  • format (optional string): The summary format ('bullet_points' or 'paragraph').
• Return Result: The generated summary text.

📚 Documentation

Fireflies API Key Configuration

Create a Fireflies API Key and set appropriate permissions:

• Log in to the Fireflies.ai management interface.
• Navigate to Settings > API page.
• Generate a new API Key.
• Copy the generated API Key.

Usage in Claude Desktop

To use this MCP server in Claude Desktop, add the following content to the claude_desktop_config.json file:

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

📦 Installation

1. Clone this repository.
2. Install dependencies:

npm install
# or
pnpm install

3. Build the project:

npm run build
# or
pnpm build

💻 Usage Examples

Starting the Server

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

You can also use the installation script:

./setup.sh
FIREFLIES_API_KEY=your_api_key npm start

📄 License

This MCP server is released under the MIT License. This means you are free to use, modify, and distribute the software, but you must comply with the terms and conditions of the MIT License. For detailed information, please refer to the LICENSE file in the project repository.