Transcript Search

Overview

Search and retrieve meeting transcripts from Fireflies.ai and Google Drive with full text and speaker attribution.

Quick Decision Tree

Where are your transcripts? │ ├── Fireflies.ai (API) │ └── references/fireflies.md │ └── Script: scripts/fireflies_transcript_search.py │ └── Google Drive (uploaded files) └── references/drive-transcripts.md └── Script: scripts/gdrive_transcript_search.py

Environment Setup

For Fireflies

FIREFLIES_API_KEY=your_api_key

For Google Drive

OAuth credentials (mycreds.txt) - see google-workspace skill

Get Fireflies API key: https://app.fireflies.ai/integrations (Custom Integrations)

Common Usage

Search Fireflies by Company

python scripts/fireflies_transcript_search.py "Microsoft" --days-back 30

Get Full Transcript

python scripts/fireflies_transcript_search.py --id 01KCM2G0YX1GMPWYQ8GPAABBCK --content

Save Formatted Transcript

python scripts/fireflies_transcript_search.py --id abc123 --content --save transcript.md

Search Drive Transcripts

python scripts/gdrive_transcript_search.py "Acme Corp" --days 30

Output Formats

Search Results

• Transcript ID, title, date, duration

• AI-generated summary, keywords, action items

• Speaker list with names

Full Transcript

• Complete text with speaker labels

• Timestamps for each sentence

• Formatted markdown output

Cost

Service Cost

Fireflies API Free (with subscription)

Google Drive Free

Security Notes

Credential Handling

• Store FIREFLIES_API_KEY in .env file (never commit to git)

• Google OAuth credentials for Drive (see google-workspace skill)

• Regenerate Fireflies API key via Custom Integrations if compromised

• Never log or print API keys in script output

Data Privacy

• Transcripts contain verbatim meeting conversations

• Speaker names and voices are identifiable

• Business discussions may include confidential information

• Action items and summaries capture sensitive decisions

• Avoid sharing full transcripts without authorization

Access Scopes

• Fireflies API: Full access to transcripts user has access to

• Google Drive: Access to uploaded transcript files

• Transcripts inherit meeting participants' access permissions

Compliance Considerations

• Recording Consent: Ensure all meeting participants consent to recording

• Speaker Privacy: Transcripts identify speakers by name

• Confidential Meetings: Some meetings should not be transcribed

• GDPR: Meeting recordings containing EU participants require consent

• Data Retention: Follow policies for transcript retention/deletion

• Legal Holds: Transcripts may be subject to legal discovery

• Client Confidentiality: Client meeting content is sensitive

• Internal Use Only: Mark transcripts as confidential where appropriate

Troubleshooting

Common Issues

Issue: Transcript not found

Symptoms: "Transcript not found" error with known meeting Cause: Invalid transcript ID, no access, or not yet processed Solution:

• Verify transcript ID from Fireflies dashboard

• Check if recording is still processing (wait and retry)

• Ensure API key has access to the transcript

• Confirm meeting was actually recorded and transcribed

Issue: API unauthorized

Symptoms: 401 error or "invalid API key" Cause: API key expired, invalid, or not set Solution:

• Regenerate API key at https://app.fireflies.ai/integrations

• Verify FIREFLIES_API_KEY is set correctly in .env

• Check for leading/trailing whitespace in key

• Ensure Custom Integration is enabled in Fireflies

Issue: Empty search results

Symptoms: Search returns no transcripts despite existing meetings Cause: Search query too narrow, date range issue, or access restrictions Solution:

• Broaden search query (fewer keywords)

• Expand date range with --days-back parameter

• Check if transcripts are shared with your account

• Verify search is using correct field (title, participants, content)

Issue: Missing transcript content

Symptoms: Metadata returned but full content is empty Cause: Transcript still processing or content access restricted Solution:

• Wait for transcript processing to complete (check Fireflies dashboard)

• Use --content flag explicitly to request full transcript

• Verify subscription tier includes API content access

• Check if transcript has processing errors

Issue: Speaker attribution missing

Symptoms: Transcript text present but speakers not identified Cause: Low audio quality or speakers not enrolled Solution:

• Speaker identification depends on audio quality

• Enroll frequent speakers in Fireflies for better recognition

• This is a Fireflies processing issue, not API issue

• Re-upload recording if possible with better audio

Issue: Google Drive transcript search fails

Symptoms: Can't find transcripts stored in Drive Cause: OAuth issue, folder structure, or file format Solution:

• Verify Google OAuth is working (see google-workspace skill)

• Check transcripts are in searchable folder

• Ensure transcripts are in readable format (txt, md, docx)

• Search by exact filename if full-text search fails

Resources

• references/fireflies.md - Fireflies.ai API guide

• references/drive-transcripts.md - Drive transcript search

Integration Patterns

Transcript to Summary

Skills: transcript-search → content-generation Use case: Create meeting summaries and action item docs Flow:

• Retrieve full transcript from Fireflies

• Extract key discussion points and decisions

• Generate formatted summary document via content-generation

Transcript to Voice Agent

Skills: transcript-search → voice-agents Use case: Build context-aware voice agents Flow:

• Search for past meetings with client

• Extract relationship history and previous discussions

• Include context in voice agent prompt for personalized calls

Transcript to CRM

Skills: transcript-search → attio-crm Use case: Add meeting notes to CRM records Flow:

• Search transcripts for client meetings

• Extract summary, action items, and key quotes

• Create note on Attio company record with meeting details