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.
When & Why to Use This Skill
This Claude skill automates the retrieval of meeting data from the Fathom API, allowing users to seamlessly sync transcripts, AI-generated summaries, and action items into their local workflow. By converting meeting records into structured Markdown files, it enhances post-meeting efficiency, ensures critical tasks are never missed, and facilitates the creation of a searchable meeting knowledge base.
Use Cases
- Automated Follow-ups: Quickly fetch action items and AI summaries from recent calls to generate follow-up emails or update project management tools.
- Knowledge Management: Sync meeting transcripts and participant details into a local 'Second Brain' or knowledge base for long-term documentation and easy searching.
- Meeting Analysis: Use the built-in analysis flag to perform deep-dives into conversation transcripts, identifying recurring themes or specific project blockers.
- Offline Archiving: Download high-quality video recordings alongside meeting notes for compliance, training, or offline review purposes.
- Daily Debriefs: Use the 'today' command to consolidate all meeting outcomes from the current day into a unified report for team stand-ups.
| 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
--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)