CtrlK
BlogDocsLog inGet started
Tessl Logo

fireflies-install-auth

Configure Fireflies.ai GraphQL API authentication and verify connectivity. Use when setting up a new Fireflies.ai integration, configuring API keys, or initializing the GraphQL client for transcript access. Trigger with phrases like "install fireflies", "setup fireflies", "fireflies auth", "configure fireflies API key".

80

Quality

77%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/saas-packs/fireflies-pack/skills/fireflies-install-auth/SKILL.md
SKILL.md
Quality
Evals
Security

Fireflies.ai Install & Auth

Overview

Set up Fireflies.ai GraphQL API authentication. Fireflies uses a single GraphQL endpoint at https://api.fireflies.ai/graphql with Bearer token auth. No SDK needed -- all interaction is via HTTP POST with GraphQL queries.

Prerequisites

  • Fireflies.ai account (Pro or higher for API access)
  • API key from app.fireflies.ai > Integrations > Fireflies API
  • Node.js 18+ or Python 3.10+
  • A GraphQL client library (optional but recommended)

Instructions

Step 1: Get Your API Key

  1. Log in at app.fireflies.ai
  2. Navigate to Integrations > Fireflies API
  3. Copy your API key (starts with a long alphanumeric string)
  4. Store it securely -- this key grants access to all your meeting data

Step 2: Configure Environment

set -euo pipefail
# Create .env file (NEVER commit to git)
echo 'FIREFLIES_API_KEY=your-api-key-here' >> .env

# Add to .gitignore
echo '.env' >> .gitignore
echo '.env.local' >> .gitignore

Step 3: Install GraphQL Client (Optional)

set -euo pipefail
# Node.js -- graphql-request is lightweight and typed
npm install graphql-request graphql

# Or use plain fetch -- no library needed
# Python -- use requests
pip install requests

Step 4: Verify Connection

// verify-fireflies.ts
const FIREFLIES_API = "https://api.fireflies.ai/graphql";

async function verifyConnection() {
  const query = `{ user { name email is_admin } }`;

  const response = await fetch(FIREFLIES_API, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${process.env.FIREFLIES_API_KEY}`,
    },
    body: JSON.stringify({ query }),
  });

  const result = await response.json();

  if (result.errors) {
    throw new Error(`Auth failed: ${result.errors[0].message}`);
  }

  const user = result.data.user;
  console.log(`Connected as: ${user.name} (${user.email})`);
  console.log(`Admin: ${user.is_admin}`);
  return user;
}

verifyConnection().catch(console.error);

Step 5: Verify with cURL

set -euo pipefail
curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -d '{"query": "{ user { name email } }"}' | jq .

Python Verification

import os, requests

FIREFLIES_API = "https://api.fireflies.ai/graphql"

def verify_connection():
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {os.environ['FIREFLIES_API_KEY']}",
    }
    query = '{ user { name email is_admin } }'
    resp = requests.post(FIREFLIES_API, json={"query": query}, headers=headers)
    data = resp.json()

    if "errors" in data:
        raise Exception(f"Auth failed: {data['errors'][0]['message']}")

    user = data["data"]["user"]
    print(f"Connected as: {user['name']} ({user['email']})")
    return user

verify_connection()

Rate Limits by Plan

PlanLimitNotes
Free / Pro50 requests/dayCannot upload audio on Free
Business60 requests/minFull API access
Enterprise60 requests/minSuper Admin webhooks

Error Handling

ErrorCodeSolution
auth_failed401Check API key is valid and not expired
too_many_requests429Rate limit hit -- back off and retry
account_cancelled403Subscription inactive -- renew plan
Network timeout-Verify outbound HTTPS to api.fireflies.ai

Output

  • Environment variable configured with API key
  • GraphQL client verified against https://api.fireflies.ai/graphql
  • User identity confirmed via user query

Resources

Next Steps

After successful auth, proceed to fireflies-hello-world for your first transcript query.

Repository
jeremylongshore/claude-code-plugins-plus-skills
Last updated
Created

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.