Tencent SkillHub · Developer Tools

Fireflies.ai

Fireflies.ai GraphQL API integration with managed OAuth. Access meeting transcripts, summaries, users, contacts, and AI-powered meeting analysis. Use this skill when users want to retrieve meeting transcripts, search conversations, analyze meeting content with AskFred, or manage meeting recordings. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.

skill openclawclawhub Free

0 Downloads

0 Stars

0 Installs

0 Score

High Signal

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Quick setup

Download the package from Yavira.
Extract the archive and review SKILL.md first.
Import or place the package into your OpenClaw setup.

Requirements

Target platform: OpenClaw
Install method: Manual import
Extraction: Extract archive
Prerequisites: OpenClaw
Primary doc: SKILL.md

Package facts

Download mode: Yavira redirect
Package format: ZIP package
Source platform: Tencent SkillHub
What's included: SKILL.md, LICENSE.txt

Validation

Use the Yavira download entry.
Review SKILL.md after the package is downloaded.
Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

Download the package from Yavira.
Extract it into a folder your agent can access.
Paste one of the prompts below and point your agent at the extracted folder.

New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Open Send to Agent page Open JSON manifest Open Markdown brief

Trust & source

Release facts

Source: Tencent SkillHub
Verification: Indexed source record
Version: 1.0.0

Provenance

Publisher: byungkyu
Source page: View original listing
Canonical URL: Open canonical page

Documentation

ClawHub primary doc Primary doc: SKILL.md 41 sections Open source page

Fireflies

Access the Fireflies.ai GraphQL API with managed OAuth authentication. Retrieve meeting transcripts, summaries, users, contacts, channels, and use AI-powered meeting analysis with AskFred.

Quick Start

# Get current user python <<'EOF' import urllib.request, os, json data = json.dumps({'query': '{ user { user_id name email is_admin } }'}).encode() req = urllib.request.Request('https://gateway.maton.ai/fireflies/graphql', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF

Base URL

https://gateway.maton.ai/fireflies/graphql All requests are sent to a single GraphQL endpoint. The gateway proxies requests to api.fireflies.ai/graphql and automatically injects your OAuth token.

Authentication

All requests require the Maton API key in the Authorization header: Authorization: Bearer $MATON_API_KEY Environment Variable: Set your API key as MATON_API_KEY: export MATON_API_KEY="YOUR_API_KEY"

Getting Your API Key

Connection Management

Manage your Fireflies OAuth connections at https://ctrl.maton.ai.

List Connections

python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=fireflies&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF

Create Connection

python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'fireflies'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF

Get Connection

python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF Response: { "connection": { "connection_id": "a221f04a-6842-4254-ae9a-424bb63ad745", "status": "ACTIVE", "creation_time": "2026-02-11T00:45:25.802991Z", "last_updated_time": "2026-02-11T00:46:04.771700Z", "url": "https://connect.maton.ai/?session_token=...", "app": "fireflies", "metadata": {} } } Open the returned url in a browser to complete OAuth authorization.

Delete Connection

python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF

Specifying Connection

If you have multiple Fireflies connections, specify which one to use with the Maton-Connection header: python <<'EOF' import urllib.request, os, json data = json.dumps({'query': '{ user { user_id name email } }'}).encode() req = urllib.request.Request('https://gateway.maton.ai/fireflies/graphql', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') req.add_header('Maton-Connection', 'a221f04a-6842-4254-ae9a-424bb63ad745') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF If omitted, the gateway uses the default (oldest) active connection.

GraphQL API

Fireflies uses GraphQL, which means all requests are POST requests to a single /graphql endpoint with a JSON body containing the query.

Request Format

POST /fireflies/graphql Content-Type: application/json { "query": "{ ... }", "variables": { ... } }

Get Current User

{ user { user_id name email is_admin num_transcripts minutes_consumed recent_transcript recent_meeting } } Response: { "data": { "user": { "user_id": "01KH5131Z0W4TS7BBSEP66CV6V", "name": "John Doe", "email": "john@example.com", "is_admin": true, "num_transcripts": null, "minutes_consumed": 0 } } }

List Users

{ users { user_id name email is_admin num_transcripts minutes_consumed } }

List Transcripts

{ transcripts { id title date duration host_email organizer_email privacy transcript_url audio_url video_url dateString calendar_type meeting_link } } With Variables (filtering): { "query": "query($limit: Int, $skip: Int) { transcripts(limit: $limit, skip: $skip) { id title date duration } }", "variables": { "limit": 10, "skip": 0 } }

Get Transcript by ID

query($id: String!) { transcript(id: $id) { id title date duration host_email privacy transcript_url audio_url summary { overview short_summary action_items outline keywords meeting_type } sentences { text speaker_name start_time end_time } participants speakers { name } } }

List Channels

{ channels { id title created_at updated_at is_private created_by } }

Get Channel by ID

query($id: String!) { channel(id: $id) { id title created_at is_private members } }

List Contacts

{ contacts { email name picture last_meeting_date } }

List User Groups

{ user_groups { id name } }

List Bites (Soundbites)

{ bites { id name transcript_id thumbnail preview status summary start_time end_time media_type created_at } }

Get Bite by ID

query($id: String!) { bite(id: $id) { id name transcript_id summary start_time end_time captions } }

List Active Meetings

{ active_meetings { id title date } }

AskFred Threads

Query meeting content using AI. List Threads: { askfred_threads { id title created_at } } Get Thread by ID: query($id: String!) { askfred_thread(id: $id) { id title messages { content role } } }

Upload Audio

mutation($input: AudioUploadInput!) { uploadAudio(input: $input) { success title message } } Variables: { "input": { "url": "https://example.com/audio.mp3", "title": "Meeting Recording" } }

Delete Transcript

mutation($id: String!) { deleteTranscript(id: $id) { success message } }

Update Meeting Title

mutation($id: String!, $title: String!) { updateMeetingTitle(id: $id, title: $title) { success } }

Update Meeting Privacy

mutation($id: String!, $privacy: String!) { updateMeetingPrivacy(id: $id, privacy: $privacy) { success } }

Update Meeting Channel

mutation($id: String!, $channelId: String!) { updateMeetingChannel(id: $id, channelId: $channelId) { success } }

Set User Role

mutation($userId: String!, $role: String!) { setUserRole(userId: $userId, role: $role) { success } }

Create Bite

mutation($input: CreateBiteInput!) { createBite(input: $input) { id name } }

AskFred Mutations

Create Thread: mutation($input: CreateAskFredThreadInput!) { createAskFredThread(input: $input) { id title } } Continue Thread: mutation($id: String!, $question: String!) { continueAskFredThread(id: $id, question: $question) { id messages { content role } } } Delete Thread: mutation($id: String!) { deleteAskFredThread(id: $id) { success } }

Live Meeting Mutations

Update Meeting State (pause/resume): mutation($id: String!, $state: String!) { updateMeetingState(id: $id, state: $state) { success } } Create Live Action Item: mutation($meetingId: String!, $text: String!) { createLiveActionItem(meetingId: $meetingId, text: $text) { success } } Create Live Soundbite: mutation($meetingId: String!, $name: String!) { createLiveSoundbite(meetingId: $meetingId, name: $name) { success } } Add Bot to Live Meeting: mutation($meetingLink: String!) { addToLiveMeeting(meetingLink: $meetingLink) { success } }

JavaScript

Python

import os import requests query = ''' { transcripts { id title date duration } } ''' response = requests.post( 'https://gateway.maton.ai/fireflies/graphql', headers={ 'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}', 'Content-Type': 'application/json' }, json={'query': query} ) data = response.json() for transcript in data['data']['transcripts']: print(f"{transcript['title']}: {transcript['duration']}s")

Notes

Fireflies uses GraphQL, not REST - all requests are POST to /graphql User IDs are ULIDs (e.g., 01KH5131Z0W4TS7BBSEP66CV6V) Timestamps are Unix timestamps (milliseconds) The summary field on transcripts contains AI-generated content: overview, action_items, outline, keywords AskFred allows natural language queries across meeting transcripts Rate limits: 50 API calls/day on free plan, more on Business plan IMPORTANT: All GraphQL queries and mutations must be sent as POST requests with Content-Type: application/json IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments

Error Handling

StatusMeaning400Invalid GraphQL query or missing connection401Invalid or missing Maton API key403Insufficient permissions429Rate limited500Internal server error GraphQL Errors: { "errors": [ { "message": "Cannot query field \"id\" on type \"User\".", "code": "GRAPHQL_VALIDATION_FAILED" } ] }

Troubleshooting: API Key Issues

Check that the MATON_API_KEY environment variable is set: echo $MATON_API_KEY Verify the API key is valid by listing connections: python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF

Troubleshooting: Invalid App Name

Ensure your URL path starts with fireflies. For example: Correct: https://gateway.maton.ai/fireflies/graphql Incorrect: https://gateway.maton.ai/graphql

Resources

Fireflies API Documentation Fireflies GraphQL API Reference Fireflies Developer Program Maton Community Maton Support

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package

1 Docs1 Files

SKILL.md Primary doc
LICENSE.txt Files