# Fireflies MCP Server

[![npm version](https://img.shields.io/npm/v/fireflies-mcp-server.svg)](https://www.npmjs.com/package/fireflies-mcp-server)
[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)

> **Supercharge your meeting workflows with seamless transcript access, search, and AI-powered summaries—right from your terminal or automation tools!**

---

## 🚀 Introduction

**Fireflies MCP Server** is an open source Modern Command Protocol (MCP) server that unlocks the full power of the [Fireflies.ai](https://fireflies.ai) API. Instantly retrieve, search, and summarize your meeting transcripts with simple commands or integrate into your favorite tools. Perfect for productivity enthusiasts, automation fans, and teams who want to get more from their meeting data.

---

## ✨ Why Fireflies MCP Server?

- **Instant Access**: Fetch and filter all your Fireflies meeting transcripts in seconds.
- **Deep Insights**: Get detailed transcript info, including speakers and full content.
- **Smart Search**: Find exactly what you need with powerful keyword and phrase search.
- **AI Summaries**: Generate concise, actionable summaries in your preferred format.
- **Easy Integration**: Works with Claude Desktop, scripts, and any MCP-compatible client.
- **Open Source & Extensible**: Community-driven, MIT-licensed, and ready for your contributions!

---

## ⚡️ Quick Start

```bash
# 1. Install (requires Node.js and npm or pnpm)
npm install -g fireflies-mcp-server

# 2. Get your Fireflies API key from https://fireflies.ai/dashboard/settings/api

# 3. Start the server
FIREFLIES_API_KEY=your_api_key fireflies-mcp-server
```

---

## 🛠 Features

- **Transcript Management**: List and filter your Fireflies meeting transcripts
- **Transcript Details**: Retrieve in-depth information for any transcript, including speakers and full content
- **Keyword Search**: Locate transcripts by searching for specific words or phrases
- **Automated Summaries**: Instantly generate concise summaries in either paragraph or bullet point format

---

## 🔌 Endpoints

- `fireflies_get_transcripts` — List transcripts (with optional filters: `limit`, `from_date`, `to_date`)
- `fireflies_get_transcript_details` — Get full details for a transcript (`transcript_id`)
- `fireflies_search_transcripts` — Search transcripts by keyword or phrase (`query`, optional `limit`)
- `fireflies_generate_summary` — Generate a summary for a transcript (`transcript_id`, optional `format`)

---

## 🧑‍💻 Setup & Usage

### 1. Prerequisites
- Node.js (v16+ recommended)
- A Fireflies API key ([get yours here](https://fireflies.ai/dashboard/settings/api))

### 2. Installation

```bash
npm install
# or
pnpm install
```

### 3. Build

```bash
npm run build
# or
pnpm build
```

### 4. (Optional) Use a Custom Build Directory

By default, the build output goes to the `dist` directory. To specify a different build/output directory, set the `BUILD_DIR` environment variable before building:

```bash
BUILD_DIR=custom-dist npm run build
```

This will output the build to `custom-dist` instead of `dist`.

### 5. Configuration for Claude Desktop

After building, you'll want to point Claude Desktop to your custom build directory. Here's what your terminal output and configuration might look like:

```bash
$ echo "Add this to your claude_desktop_config.json mcpServers array:"
Add this to your claude_desktop_config.json mcpServers array:

{
  "mcpServers": {
    "fireflies": {
      "command": "node",
      "args": ["/absolute/path/to/custom-dist/index.js"],
      "env": {
        "FIREFLIES_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}
```

Replace `/absolute/path/to/custom-dist/index.js` with the actual path to your custom build output.

### 6. Running the Server

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

Or use the setup script:

```bash
./setup.sh
FIREFLIES_API_KEY=your_api_key npm start
```

---

## 🤝 Contributing

We love contributions! Whether it's a bug fix, new feature, or documentation improvement, your help is welcome. Please check out [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines, or open an issue to start a discussion.

---

## 💬 Community & Support

- [Fireflies.ai Documentation](https://fireflies.ai/docs)
- [GitHub Issues](https://github.com/your-org/fireflies-mcp-server/issues) — for bug reports and feature requests
- Join the conversation! PRs and feedback are always appreciated.

---

## 📄 License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.