Fathom

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)