fathom — Claude Code skill: fetch Fathom meetings and transcripts
Skill to retrieve meetings, transcripts, AI summaries, and action items directly from Fathom API. Use it to sync meeting recordings and transcripts into your coding workflow.
MIT 249 installs ★ 414 updated 2026-10-23
npx skills add glebis/claude-skills --skill fathom -a claude-codeWhat fathom does
fathom pulls meeting data from Fathom API: full transcripts, AI-generated summaries, action item lists, and participant details. The skill runs via command line and filters by date, meeting ID, or single-day retrieval. Results save as markdown files with frontmatter, ready for knowledge base integration.
Video downloads require ffmpeg installed. Store your Fathom API key in .env file before first use. The skill supports --analyze to process transcripts automatically or --download-video to save video files alongside markdown output.
What it helps with
- pull all meetings from a specific day into one place
- sync Fathom transcripts to local storage
- extract action items and summaries for documentation
- download meeting videos with metadata
Example prompts for the agent
- Show me today's Fathom meetings
- Fetch meeting abc123def456 with video and summary
- Sync all meetings since 2025-01-01 and analyze them
How to install fathom
1Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill fathom -a claude-code2Manually: put the files in place
~/.claude/skills/fathom/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/fathom/
1Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill fathom -a codex2Manually: put the files in place
.agents/skills/fathom/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill fathom -a cursor2Manually: put the files in place
.cursor/skills/fathom/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install glebis/claude-skills fathom2Manually: put the files in place
.github/skills/fathom/SKILL.md1Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill fathom -a gemini-cli2Platform CLI
gemini skills install https://github.com/glebis/claude-skills --path fathomManually: put the files in place
.devin/skills/fathom/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill fathom -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about fathom
How do I install fathom in Claude Code?
Run npx skills add glebis/claude-skills --skill fathom -a claude-code, then review ~/.claude/skills/fathom/SKILL.md to verify.
What does fathom do?
It retrieves meetings, transcripts, AI summaries, and action items from Fathom API, saving them as markdown files with metadata. It can also download video recordings automatically.
What dependencies does fathom need?
Install requests and python-dotenv via pip install requests python-dotenv. Video downloads require ffmpeg. You'll need a Fathom API key in ~/.claude/skills/fathom/scripts/.env.
Source text
SKILL.md · MIT
---
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
```bash
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
```bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --list
```
### Fetch today's meetings
```bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --today
```
### Fetch and analyze
```bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --today --analyze
```
### Fetch since date
```bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --since 2025-01-01
```
### Fetch specific meeting
```bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --id abc123def456
```
### Download video with meeting
```bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --id abc123def456 --download-video
```
## Output Format
Each meeting is saved as markdown with:
```markdown
---
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):
```bash
pip install requests python-dotenv
```
For video download (optional):
```bash
# 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)
© glebis · MIT · glebis/claude-skills