Fireflies MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'firefliesmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Fireflies MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'firefliesmcp_fireflies_fetch',
     toolInput: { id: 'YOUR_ID' },
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "firefliesmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Fireflies MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={"id":"YOUR_ID"},
       tool_name="firefliesmcp_fireflies_fetch",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Update fireflies — Rename a meeting transcript by its ID
• Meeting fireflies share, fireflies move — Share a meeting transcript with one or more email addresses
• Search fireflies — Search meeting transcripts using keywords or Fireflies mini-grammar syntax
• Access fireflies revoke meeting — Revoke a previously shared meeting access for a specific email address
• List fireflies — List all channels (folders) available to the authenticated user
• Get fireflies — Fetch user groups for the authenticated user or their team

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

firefliesmcp_fireflies_create_soundbite#Create a short audio or transcript clip from a meeting recording by specifying start and end times.7 params▾

Create a short audio or transcript clip from a meeting recording by specifying start and end times.

NameTypeRequiredDescription

endTimenumberrequiredEnd time of the soundbite clip in seconds from the beginning of the recording.

startTimenumberrequiredStart time of the soundbite clip in seconds from the beginning of the recording.

transcriptIdstringrequiredThe Fireflies transcript ID of the meeting to clip. Get it from the search or fetch tool.

mediaTypestringoptionalThe media type for the soundbite clip (e.g. audio or video).

namestringoptionalA short label for the soundbite clip.

privaciesarrayoptionalAccess levels for the soundbite. Pass as a JSON array via the SDK.

summarystringoptionalA brief description of what this soundbite captures.

firefliesmcp_fireflies_fetch#Retrieve the full transcript, metadata, and insights for a single Fireflies meeting by its ID.1 param▾

Retrieve the full transcript, metadata, and insights for a single Fireflies meeting by its ID.

NameTypeRequiredDescription

idstringrequiredThe Fireflies transcript ID of the meeting to fetch. Get it from the search tool.

firefliesmcp_fireflies_get_analytics#Retrieve team and per-user meeting analytics for a given date range.2 params▾

Retrieve team and per-user meeting analytics for a given date range.

NameTypeRequiredDescription

endTimestringoptionalEnd of the analytics date range (ISO 8601 datetime).

startTimestringoptionalStart of the analytics date range (ISO 8601 datetime).

firefliesmcp_fireflies_get_channel#Retrieve details of a specific Fireflies channel (folder) by its ID.1 param▾

Retrieve details of a specific Fireflies channel (folder) by its ID.

NameTypeRequiredDescription

channelIdstringrequiredThe ID of the channel/folder. Get it from the list_channels tool.

firefliesmcp_fireflies_get_rule_executions#Retrieve automation rule execution logs grouped by meeting, with optional filters.6 params▾

Retrieve automation rule execution logs grouped by meeting, with optional filters.

NameTypeRequiredDescription

cursorstringoptionalPagination cursor from the previous response to fetch the next page.

dateFromstringoptionalFilter rule executions on or after this date (YYYY-MM-DD).

dateTostringoptionalFilter rule executions on or before this date (YYYY-MM-DD).

limitintegeroptionalMaximum number of items to return.

meetingIdstringoptionalThe Fireflies transcript ID of the meeting. Get it from the search tool.

ruleIdstringoptionalThe ID of the automation rule to filter by.

firefliesmcp_fireflies_get_soundbites#Fetch a list of soundbite clips, optionally filtered by meeting or ownership.6 params▾

Fetch a list of soundbite clips, optionally filtered by meeting or ownership.

NameTypeRequiredDescription

formatstringoptionalResponse format. Accepted values: json, text, toon.

limitnumberoptionalMaximum number of items to return.

minebooleanoptionalSet to true to return only your own items.

my_teambooleanoptionalSet to true to include items from your team members.

skipnumberoptionalNumber of items to skip for pagination.

transcript_idstringoptionalFilter soundbites to a specific meeting transcript ID. Get it from the search tool.

firefliesmcp_fireflies_get_user#Fetch account details for a Fireflies user; defaults to the currently authenticated user.1 param▾

Fetch account details for a Fireflies user; defaults to the currently authenticated user.

NameTypeRequiredDescription

userIdstringoptionalThe Fireflies user ID. Leave empty to fetch the currently authenticated user.

firefliesmcp_fireflies_get_user_contacts#Fetch the contact list for the authenticated Fireflies user.1 param▾

Fetch the contact list for the authenticated Fireflies user.

NameTypeRequiredDescription

formatstringoptionalResponse format. Accepted values: json, text, toon.

firefliesmcp_fireflies_get_usergroups#Fetch user groups for the authenticated user or their team.1 param▾

Fetch user groups for the authenticated user or their team.

NameTypeRequiredDescription

minebooleanoptionalSet to true to return only your own items.

firefliesmcp_fireflies_list_channels#List all channels (folders) available to the authenticated user.0 params▾

List all channels (folders) available to the authenticated user.

firefliesmcp_fireflies_move_meeting#Move one or more meeting transcripts to a specified channel or folder.2 params▾

Move one or more meeting transcripts to a specified channel or folder.

NameTypeRequiredDescription

channelIdstringrequiredThe ID of the channel/folder. Get it from the list_channels tool.

meetingIdsarrayrequiredArray of meeting IDs / transcript IDs to move (max 5)

firefliesmcp_fireflies_revoke_meeting_access#Revoke a previously shared meeting access for a specific email address.2 params▾

Revoke a previously shared meeting access for a specific email address.

NameTypeRequiredDescription

emailstringrequiredThe email address of the user whose access to revoke.

meetingIdstringrequiredThe Fireflies transcript ID of the meeting. Get it from the search tool.

firefliesmcp_fireflies_search#Search meeting transcripts using keywords or Fireflies mini-grammar syntax.2 params▾

Search meeting transcripts using keywords or Fireflies mini-grammar syntax.

NameTypeRequiredDescription

querystringrequiredSearch query using the mini grammar syntax. Can be simple keywords or complex filters using the grammar.

formatstringoptionalResponse format. Accepted values: json, text, toon.

firefliesmcp_fireflies_share_meeting#Share a meeting transcript with one or more email addresses.3 params▾

Share a meeting transcript with one or more email addresses.

NameTypeRequiredDescription

emailsarrayrequiredArray of email addresses to share the meeting with (max 100)

meetingIdstringrequiredThe Fireflies transcript ID of the meeting. Get it from the search tool.

expiryDaysnumberoptionalNumber of days before the shared link expires. Leave empty for no expiry.

firefliesmcp_fireflies_update_meeting_privacy#Update the privacy level of a meeting transcript.2 params▾

Update the privacy level of a meeting transcript.

NameTypeRequiredDescription

meetingIdstringrequiredThe Fireflies transcript ID of the meeting. Get it from the search tool.

privacystringrequiredWho can view this meeting. Accepted values: link, owner, participants, participatingteammates, teammatesandparticipants, teammates.

firefliesmcp_fireflies_update_meeting_title#Rename a meeting transcript by its ID.2 params▾

Rename a meeting transcript by its ID.

NameTypeRequiredDescription

meetingIdstringrequiredThe Fireflies transcript ID of the meeting. Get it from the search tool.

titlestringrequiredThe new title for the meeting transcript.