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.

Name Type Required Description

endTime number required End time of the soundbite clip in seconds from the beginning of the recording.

startTime number required Start time of the soundbite clip in seconds from the beginning of the recording.

transcriptId string required The Fireflies transcript ID of the meeting to clip. Get it from the search or fetch tool.

mediaType string optional The media type for the soundbite clip (e.g. audio or video).

name string optional A short label for the soundbite clip.

privacies array optional Access levels for the soundbite. Pass as a JSON array via the SDK.

summary string optional A 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.

Name Type Required Description

id string required The 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.

Name Type Required Description

endTime string optional End of the analytics date range (ISO 8601 datetime).

startTime string optional Start 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.

Name Type Required Description

channelId string required The 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.

Name Type Required Description

cursor string optional Pagination cursor from the previous response to fetch the next page.

dateFrom string optional Filter rule executions on or after this date (YYYY-MM-DD).

dateTo string optional Filter rule executions on or before this date (YYYY-MM-DD).

limit integer optional Maximum number of items to return.

meetingId string optional The Fireflies transcript ID of the meeting. Get it from the search tool.

ruleId string optional The 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.

Name Type Required Description

format string optional Response format. Accepted values: json, text, toon.

limit number optional Maximum number of items to return.

mine boolean optional Set to true to return only your own items.

my_team boolean optional Set to true to include items from your team members.

skip number optional Number of items to skip for pagination.

transcript_id string optional Filter 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.

Name Type Required Description

userId string optional The 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.

Name Type Required Description

format string optional Response 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.

Name Type Required Description

mine boolean optional Set 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.

Name Type Required Description

channelId string required The ID of the channel/folder. Get it from the list_channels tool.

meetingIds array required Array 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.

Name Type Required Description

email string required The email address of the user whose access to revoke.

meetingId string required The 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.

Name Type Required Description

query string required Search query using the mini grammar syntax. Can be simple keywords or complex filters using the grammar.

format string optional Response 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.

Name Type Required Description

emails array required Array of email addresses to share the meeting with (max 100)

meetingId string required The Fireflies transcript ID of the meeting. Get it from the search tool.

expiryDays number optional Number 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.

Name Type Required Description

meetingId string required The Fireflies transcript ID of the meeting. Get it from the search tool.

privacy string required Who 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.

Name Type Required Description

meetingId string required The Fireflies transcript ID of the meeting. Get it from the search tool.

title string required The new title for the meeting transcript.