OpenParable
Skip to content
← Back to skills

Fireflies Install Auth

Apps & Automation
fireflies-install-auth

Fireflies Install Auth is an Agent Skill for apps & automation published in the jeremylongshore/claude-code-plugins-plus-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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".

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/HEAD/plugins/saas-packs/fireflies-pack/skills/fireflies-install-auth/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/fireflies-install-auth, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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.