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.
You'll need a Fireflies API key before setting up the server:
There are two main ways to use this MCP server:
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.
npm install
# or
pnpm install
npm run build
# or
pnpm build
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
The Fireflies MCP server provides four main tools:
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")
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")
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)
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.
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.
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.
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>"
}
}
}
}
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.
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.
To add this MCP server to Claude Desktop:
1. Find your configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
~/.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