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