fireflies-install-auth

name	fireflies-install-auth
description	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".
allowed-tools	Read, Write, Edit, Bash(npm:*), Bash(curl:*), Grep
version	1.11.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","fireflies","api","authentication"]
compatibility	Designed for Claude Code

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 =  (, {
    : ,
    : {
      : ,
      : ,
    },
    : .({ query }),
  });

   result =  response.();

   (result.) {
      ();
  }

   user = result..;
  .();
  .();
   user;
}

().(.);