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 --listFetch today's meetings
python3 ~/.claude/skills/fathom/scripts/fetch.py --todayFetch and analyze
python3 ~/.claude/skills/fathom/scripts/fetch.py --today --analyzeFetch since date
python3 ~/.claude/skills/fathom/scripts/fetch.py --since 2025-01-01Fetch specific meeting
python3 ~/.claude/skills/fathom/scripts/fetch.py --id abc123def456Download video with meeting
python3 ~/.claude/skills/fathom/scripts/fetch.py --id abc123def456 --download-videoOutput 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-dotenvFor 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-keyIntegration
- transcript-analyzer: Use
--analyzeflag to automatically process transcripts - video-downloader: Use
--download-videoflag 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)