fathom

name	fathom
description	Fetch meetings, transcripts, summaries, and action items from Fathom API. Use when user asks to get Fathom recordings, sync meeting transcripts, or fetch recent calls.

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)