Fireflies.ai
Read Fireflies meeting transcripts, AI summaries, and action items via MCP. API key setup, scoped read access, and private gateway support.
Overview
Connect Fireflies.ai so AI clients can read meeting transcripts, AI summaries, and action items from Zoom, Google Meet, Microsoft Teams, and other meetings Fireflies records.
stackgate.ai stores your Fireflies API key encrypted and calls the Fireflies GraphQL API on your behalf. Transcript and summary content is returned to your AI client for that request — it is not kept in the hub unless you explicitly store a transcript in Temp Storage for cross-tool handoff (TTL applies).
Prerequisites
- A Fireflies.ai account with API access
- A stackgate.ai account
Getting credentials
- Sign in to stackgate.ai.
- Go to My Integrations and open Fireflies.ai.
- In a separate tab, log in to Fireflies.
- Open Integrations → Fireflies API, or go to Settings → Developer settings.
- Copy your API key.
- Paste the key into stackgate.ai and click Save.
- Optionally use Edit tool access to limit which read tools the connection may use.
Treat the API key like a password. Revoke or rotate it in Fireflies if it is exposed.
Using with AI clients
- Dedicated endpoint:
POST /mcp/fireflieswith a Sanctum bearer token - Private gateway: one config for all integrations — use
fireflies__*namespaced tools
See Documentation for HTTP authentication and private gateway setup.
Suggested workflow: Deal recap to CRM
- Use Fireflies tools to find the customer call and pull the summary/action items.
- Create or update a HubSpot/Salesforce note or deal activity with the recap.
- Optionally draft a follow-up email in Gmail or post a short update in Slack.
Retention, deletion, and meeting platforms
- Hub retention: Encrypted API key while the integration stays connected. MCP audit logs record tool names and status — not transcript text. Temp Storage copies expire by TTL (default two hours, maximum twenty-four).
- Deletion: Disconnect Fireflies in My Integrations to remove the stored key. Delete or manage meetings inside Fireflies; revoke the API key in Fireflies Developer settings to cut off API access.
- Platform boundaries: stackgate.ai talks only to Fireflies. Zoom, Meet, and Teams recording/consent rules are governed by Fireflies and those platforms — not by stackgate.ai.
Meeting content can include sensitive personal data. Prefer summary tools over full transcripts when possible, and scope tool access carefully for shared company accounts.
Troubleshooting
- 422 integration not configured — add your Fireflies API key in My Integrations.
- 401 / authentication failed — verify the key in Fireflies Developer settings; create a new key if it was revoked.
- 429 rate limit — Fireflies limits Free plans to 50 requests/day and Pro to 500/day (Business/Enterprise: 60/min). Wait or upgrade your Fireflies plan.
- Keyword search finds nothing — keyword maps to Fireflies title filter, not full-text body search. Try a shorter title fragment, or filter by participant/host email and date.
- Large transcripts blow context — use
get_transcriptwithoutput_mode=temp_storage, then read the file via Temp Storage tools.
Available tools
-
get_user
Return the connected Fireflies user profile and transcript usage metadata.
-
list_transcripts
List Fireflies meeting transcripts. Filter by title/keyword (title match), host email, participant email, or meeting date (unix ms). Paginate with limit and skip.
-
get_summary
Get the AI summary, action items, keywords, and overview for a Fireflies transcript. Prefer this over the full transcript when possible.
-
get_transcript
Get a full Fireflies transcript including sentences. Use output_mode=temp_storage for large meetings so other tools can read the file via temp storage.
MCP endpoint:
https://stackgate.ai/mcp/fireflies
(HTTP) or via the
private gateway.