fathom
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.
SKILL.md
Full skill instructions
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
--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)