Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1700+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

How to integrate Fireflies MCP with CrewAI

Connect CrewAI to Fireflies MCP. Transcribe this uploaded meeting audio file, summarize your last five recorded calls, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Fireflies

Api Key

Fireflies.ai is an AI-powered meeting assistant that records, transcribes, and analyzes voice conversations. It helps teams capture call notes automatically and search or summarize meetings effortlessly.

26 Tools1 Triggers

Managed auth

Connect Fireflies without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

This guide walks you through connecting Fireflies to CrewAI using the Composio tool router. By the end, you'll have a working Fireflies agent that can search and fetch transcripts, query meetings with AskFred, review meeting analytics, upload audio, and create meeting clips through natural language commands.

This guide will help you understand how to give your CrewAI agent real control over a Fireflies account through Composio's Fireflies MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

TL;DR

Here's what you'll learn:

Get a Composio API key and configure your Fireflies connection
Set up CrewAI with an MCP enabled agent
Create a Tool Router session or standalone MCP server for Fireflies
Build a conversational loop where your agent can execute Fireflies operations

What is CrewAI?

CrewAI is a powerful framework for building multi-agent AI systems. It provides primitives for defining agents with specific roles, creating tasks, and orchestrating workflows through crews.

Key features include:

Agent Roles: Define specialized agents with specific goals and backstories
Task Management: Create tasks with clear descriptions and expected outputs
Crew Orchestration: Combine agents and tasks into collaborative workflows
MCP Integration: Connect to external tools through Model Context Protocol

What is the Fireflies MCP server, and what's possible with it?

The Fireflies MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Fireflies account. It provides structured and secure access to your meeting transcripts, analytics, participants, topics, channels, user groups, and AskFred conversations, so your agent can search conversations, analyze meetings, review attendance, explore topics, and retrieve AskFred discussions on your behalf.

Transcript search: Have your agent search meeting titles and spoken content for keywords to find relevant conversations.
Meeting insights and analytics: Let the agent review conversation metrics, sentiment, team trends, and individual performance data from your meetings.
Participants and attendance: Direct your agent to retrieve meeting participants and review their attendance details.
Topics and AskFred conversations: Instruct your agent to identify extracted topics, keywords, and meeting types, or retrieve AskFred threads with their full history.
Team organization and roles: Have your agent list accessible channels and user groups, review group membership, or update a team member's role.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step08 STEPS

Prerequisites

Before starting, make sure you have:

Python 3.9 or higher
A Composio account and API key
A Fireflies connection authorized in Composio
An OpenAI API key for the CrewAI LLM
Basic familiarity with Python

Getting API Keys for OpenAI and Composio

OpenAI API Key

Go to the OpenAI dashboard and create an API key. You'll need credits to use the models, or you can connect to another model provider.
Keep the API key safe.

Composio API Key

Log in to the Composio dashboard.
Navigate to your API settings and generate a new API key.
Store this key securely as you'll need it for authentication.

Install dependencies

bash

pip install composio crewai crewai-tools[mcp] python-dotenv

What's happening:

composio connects your agent to Fireflies via MCP
crewai provides Agent, Task, Crew, and LLM primitives
crewai-tools[mcp] includes MCP helpers
python-dotenv loads environment variables from .env

Set up environment variables

bash

COMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here
OPENAI_API_KEY=your_openai_api_key_here

Create a .env file in your project root.

What's happening:

COMPOSIO_API_KEY authenticates with Composio
USER_ID scopes the session to your account
OPENAI_API_KEY lets CrewAI use your chosen OpenAI model

Import dependencies

python

import os
from composio import Composio
from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
import dotenv

dotenv.load_dotenv()

COMPOSIO_API_KEY = os.getenv("COMPOSIO_API_KEY")
COMPOSIO_USER_ID = os.getenv("COMPOSIO_USER_ID")

if not COMPOSIO_API_KEY:
    raise ValueError("COMPOSIO_API_KEY is not set")
if not COMPOSIO_USER_ID:
    raise ValueError("COMPOSIO_USER_ID is not set")

What's happening:

CrewAI classes define agents and tasks, and run the workflow
MCPServerHTTP connects the agent to an MCP endpoint
Composio will give you a short lived Fireflies MCP URL

Create a Composio Tool Router session for Fireflies

python

composio_client = Composio(api_key=COMPOSIO_API_KEY)
session = composio_client.create(user_id=COMPOSIO_USER_ID, toolkits=["fireflies"])

url = session.mcp.url

What's happening:

You create a Fireflies only session through Composio
Composio returns an MCP HTTP URL that exposes Fireflies tools

Initialize the MCP Server

python

server_params = {
    "url": url,
    "transport": "streamable-http",
    "headers": {"x-api-key": COMPOSIO_API_KEY},
}

with MCPServerAdapter(server_params) as tools:
    agent = Agent(
        role="Search Assistant",
        goal="Help users search the internet effectively",
        backstory="You are a helpful assistant with access to search tools.",
        tools=tools,
        verbose=False,
        max_iter=10,
    )

What's Happening:

Server Configuration: The code sets up connection parameters including the MCP server URL, streamable HTTP transport, and Composio API key authentication.
MCP Adapter Bridge: MCPServerAdapter acts as a context manager that converts Composio MCP tools into a CrewAI-compatible format.
Agent Setup: Creates a CrewAI Agent with a defined role (Search Assistant), goal (help with internet searches), and access to the MCP tools.
Configuration Options: The agent includes settings like verbose=False for clean output and max_iter=10 to prevent infinite loops.
Dynamic Tool Usage: Once created, the agent automatically accesses all Composio Search tools and decides when to use them based on user queries.

Create a CLI Chatloop and define the Crew

python

print("Chat started! Type 'exit' or 'quit' to end.\n")

conversation_context = ""

while True:
    user_input = input("You: ").strip()

    if user_input.lower() in ["exit", "quit", "bye"]:
        print("\nGoodbye!")
        break

    if not user_input:
        continue

    conversation_context += f"\nUser: {user_input}\n"
    print("\nAgent is thinking...\n")

    task = Task(
        description=(
            f"Conversation history:\n{conversation_context}\n\n"
            f"Current request: {user_input}"
        ),
        expected_output="A helpful response addressing the user's request",
        agent=agent,
    )

    crew = Crew(agents=[agent], tasks=[task], verbose=False)
    result = crew.kickoff()
    response = str(result)

    conversation_context += f"Agent: {response}\n"
    print(f"Agent: {response}\n")

What's Happening:

Interactive CLI Setup: The code creates an infinite loop that continuously prompts for user input and maintains the entire conversation history in a string variable.
Input Validation: Empty inputs are ignored to prevent processing blank messages and keep the conversation clean.
Context Building: Each user message is appended to the conversation context, which preserves the full dialogue history for better agent responses.
Dynamic Task Creation: For every user input, a new Task is created that includes both the full conversation history and the current request as context.
Crew Execution: A Crew is instantiated with the agent and task, then kicked off to process the request and generate a response.
Response Management: The agent's response is converted to a string, added to the conversation context, and displayed to the user, maintaining conversational continuity.

Complete Code

Here's the complete code to get you started with Fireflies and CrewAI:

python

from crewai import Agent, Task, Crew, LLM
from crewai_tools import MCPServerAdapter
from composio import Composio
from dotenv import load_dotenv
import os

load_dotenv()

GOOGLE_API_KEY = os.getenv("GOOGLE_API_KEY")
COMPOSIO_API_KEY = os.getenv("COMPOSIO_API_KEY")
COMPOSIO_USER_ID = os.getenv("COMPOSIO_USER_ID")

if not GOOGLE_API_KEY:
    raise ValueError("GOOGLE_API_KEY is not set in the environment.")
if not COMPOSIO_API_KEY:
    raise ValueError("COMPOSIO_API_KEY is not set in the environment.")
if not COMPOSIO_USER_ID:
    raise ValueError("COMPOSIO_USER_ID is not set in the environment.")

# Initialize Composio and create a session
composio = Composio(api_key=COMPOSIO_API_KEY)
session = composio.create(
    user_id=COMPOSIO_USER_ID,
    toolkits=["fireflies"],
)
url = session.mcp.url

# Configure LLM
llm = LLM(
    model="gpt-5",
    api_key=os.getenv("OPENAI_API_KEY"),
)

server_params = {
    "url": url,
    "transport": "streamable-http",
    "headers": {"x-api-key": COMPOSIO_API_KEY},
}

with MCPServerAdapter(server_params) as tools:
    agent = Agent(
        role="Search Assistant",
        goal="Help users with internet searches",
        backstory="You are an expert assistant with access to Composio Search tools.",
        tools=tools,
        llm=llm,
        verbose=False,
        max_iter=10,
    )

    print("Chat started! Type 'exit' or 'quit' to end.\n")

    conversation_context = ""

    while True:
        user_input = input("You: ").strip()

        if user_input.lower() in ["exit", "quit", "bye"]:
            print("\nGoodbye!")
            break

        if not user_input:
            continue

        conversation_context += f"\nUser: {user_input}\n"
        print("\nAgent is thinking...\n")

        task = Task(
            description=(
                f"Conversation history:\n{conversation_context}\n\n"
                f"Current request: {user_input}"
            ),
            expected_output="A helpful response addressing the user's request",
            agent=agent,
        )

        crew = Crew(agents=[agent], tasks=[task], verbose=False)
        result = crew.kickoff()
        response = str(result)

        conversation_context += f"Agent: {response}\n"
        print(f"Agent: {response}\n")

Conclusion

You now have a CrewAI agent connected to Fireflies through Composio's Tool Router. The agent can perform Fireflies operations through natural language commands.

Next steps:

Add role-specific instructions to customize agent behavior
Plug in more toolkits for multi-app workflows
Chain tasks for complex multi-step operations

TOOLS & TRIGGERS

Supported Tools and Triggers

Every Fireflies action and event your agent gets out of the box.

Add to Live Meeting

The AddToLive Action allows you to add the Fireflies.

Continue AskFred Thread

Tool to continue an existing AskFred conversation thread with follow-up questions.

Create AskFred Thread

Starts a new AskFred conversation with a natural-language question about one meeting or multiple meetings using filters.

Create Bite

Tool to create a bite (short video or audio clip) from a transcript segment.

Delete Transcript by ID

Permanently delete a transcript from the Fireflies account by its unique ID.

Fetch AI App Outputs

Tool to fetch AI App outputs for specific apps or transcripts.

Get AskFred Thread

Tool to get a specific AskFred conversation thread with full history.

Get AskFred Threads

Tool to retrieve a summary of all AskFred conversation threads for the current user.

Get Bite by ID

Fetches details for a specific bite by ID.

Get Transcripts

Fetches a list of bites (highlights) against input arguments.

Get Meeting Analytics

Retrieves comprehensive meeting analytics including team-level conversation metrics, sentiment analysis, and individual user performance data.

Get Meeting Participants

Retrieves the list of participants who attended a specific Fireflies meeting along with their attendance details.

Get Meeting Topics

Retrieves AI-extracted topics, keywords, and meeting type for a specific Fireflies transcript.

Get Transcript by ID

Fetches details for a specific Fireflies transcript ID, including sentences, attendees and summary when available.

Get Transcripts

Fetches a list of transcripts against input filters.

Get User by ID

The GetUser Action is designed to fetch details associated with a specific user id.

Get User Groups

Tool to fetch a list of all user groups within the team with information about user groups including their members.

Get Users

Fetches a list of all users within the team, including their full email addresses.

Execute GraphQL Query

Executes an authenticated, read-only Fireflies GraphQL query and returns validated data, errors, and extensions when available.

List Channels

Fetches a list of all channels accessible to the authenticated user, including both public channels and private channels where the user is a member.

Search Transcripts

Search transcripts using keyword-based full-text search across meeting titles and/or spoken content.

Set User Role

Tool to update a user's role within a team.

Update Meeting Channel

Tool to batch update channel assignments for 1-5 meeting transcripts.

Update Meeting Privacy

Tool to update the privacy setting of a meeting transcript.

Update Meeting Title

Tool to update the title of a meeting transcript.

Upload Audio

The UploadAudio Action allows you to upload audio files to Fireflies.

FRAMEWORKS

How to build Fireflies MCP Agent with another framework

Claude Code

Use Fireflies MCP with Claude Code

Cursor

Use Fireflies MCP with Cursor

ChatGPT

Use Fireflies MCP with ChatGPT

Claude Cowork

Use Fireflies MCP with Claude Cowork

Antigravity

Use Fireflies MCP with Antigravity

OpenAI Agents SDK

Use Fireflies MCP with OpenAI Agents SDK

Claude Agent SDK

Use Fireflies MCP with Claude Agent SDK

Muse

Use Fireflies MCP with Muse

Codex

Use Fireflies MCP with Codex

Grok Build

Use Fireflies MCP with Grok Build

VS Code

Use Fireflies MCP with VS Code

OpenCode

Use Fireflies MCP with OpenCode

OpenClaw

Use Fireflies MCP with OpenClaw

Hermes

Use Fireflies MCP with Hermes

Atomic Agent

Use Fireflies MCP with Atomic Agent

Google ADK

Use Fireflies MCP with Google ADK

LangChain

Use Fireflies MCP with LangChain

Vercel AI SDK

Use Fireflies MCP with Vercel AI SDK

Mastra AI

Use Fireflies MCP with Mastra AI

LlamaIndex

Use Fireflies MCP with LlamaIndex

Pydantic AI

Use Fireflies MCP with Pydantic AI

AutoGen

Use Fireflies MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Firecrawl

Api Key

Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.

Tavily

Api Key

Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.

Exa

Api Key

Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows.

Serpapi

Api Key

SerpApi is a real-time API for structured search engine results. It lets you automate SERP data collection, parsing, and analysis for SEO and research.

FAQ

Frequently asked questions

With a standalone Fireflies MCP server, the agents and LLMs can only access a fixed set of Fireflies tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Fireflies and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. CrewAI fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Fireflies tools.

Yes, absolutely. You can configure which Fireflies scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Fireflies data and credentials are handled as safely as possible.

Start with Fireflies.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Fireflies tool your agent needs.Free to start.

Start building

How to integrate Fireflies MCP with CrewAI

Connect Fireflies without auth hassles

Introduction

Also integrate Fireflies with

TL;DR

What is CrewAI?

What is the Fireflies MCP server, and what's possible with it?

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

How the Composio SDK works

Step-by-step Guide

Prerequisites

Getting API Keys for OpenAI and Composio

Install dependencies

Set up environment variables

Import dependencies

Create a Composio Tool Router session for Fireflies

Initialize the MCP Server

Create a CLI Chatloop and define the Crew

Complete Code

Conclusion

Supported Tools and Triggers

How to build Fireflies MCP Agent with another framework

Claude Code

Cursor

ChatGPT

Claude Cowork

Antigravity

OpenAI Agents SDK

Claude Agent SDK

Muse

Codex

Grok Build

VS Code

OpenCode

OpenClaw

Hermes

Atomic Agent

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

Pydantic AI

AutoGen

Explore Other Toolkits

Firecrawl

Tavily

Exa

Serpapi

Frequently asked questions

What are the differences in Tool Router MCP and Fireflies MCP?

Can I use Tool Router MCP with CrewAI?

Can I manage the permissions and scopes for Fireflies while using Tool Router?

How safe is my data with Composio Tool Router?

Start with Fireflies.It takes 30 seconds.