Fathom Meeting Fetcher

Fetches meeting data directly from Fathom API including transcripts, AI summaries, action items, and participant info.

Usage

python3 ~/.claude/skills/fathom/scripts/fetch.py [options]

Commands

Command	Description
--list	List recent meetings with IDs
--id <id>	Fetch specific meeting by recording ID
--today	Fetch all meetings from today
--since <date>	Fetch meetings since date (YYYY-MM-DD)

Options

Option	Description
--analyze	Run transcript-analyzer on fetched meetings
--download-video	Download video recording (requires ffmpeg)
--output <path>	Output directory (default: ~/Brains/brain)
--limit <n>	Max meetings to list (default: 10)

Examples

List recent meetings

python3 ~/.claude/skills/fathom/scripts/fetch.py --list

Fetch today's meetings

python3 ~/.claude/skills/fathom/scripts/fetch.py --today

Fetch and analyze

python3 ~/.claude/skills/fathom/scripts/fetch.py --today --analyze

Fetch since date

python3 ~/.claude/skills/fathom/scripts/fetch.py --since 2025-01-01

Fetch specific meeting

python3 ~/.claude/skills/fathom/scripts/fetch.py --id abc123def456

Download video with meeting

python3 ~/.claude/skills/fathom/scripts/fetch.py --id abc123def456 --download-video

Output Format

Each meeting is saved as markdown with:

---
fathom_id: <id>
title: "Meeting Title"
date: YYYY-MM-DD
participants: [list]
duration: HH:MM
fathom_url: <url>
share_url: <url>
---

# Meeting Title

## Summary
{AI-generated summary from Fathom}

## Action Items
- [ ] Item 1 (@assignee)
- [ ] Item 2

## Transcript
**Speaker Name**: What they said...

File Naming

Files are saved as: YYYYMMDD-meeting-title-slug.md

Example: 20250106-weekly-standup.md

Prerequisites

Install dependencies (first time):

pip install requests python-dotenv

For video download (optional):

# ffmpeg required for video downloads
brew install ffmpeg  # macOS
# or apt install ffmpeg (Linux)

Configuration

API key stored in ~/.claude/skills/fathom/scripts/.env:

FATHOM_API_KEY=your-api-key

Integration

• transcript-analyzer: Use --analyze flag to automatically process transcripts
• video-downloader: Use --download-video flag to download meeting recordings
  • Validates downloaded videos using ffprobe
  • Automatically retries up to 3 times if download fails
  • Videos saved as .mp4 next to meeting markdown files
• Replaces Dropbox sync workflow (direct API access)