fathom
Fetch meetings, transcripts, AI summaries, and action items from the Fathom API via the bundled Python CLI (scripts/fetch.py). Use when the user asks to get Fathom recordings, sync meeting transcripts
SKILL.mdskills/productivity/video-conf/fathom/SKILL.md
GitHubTO COPY
fathom
Per-workspace registration slice. Credentials live in {SKILL_PATH}/.env.
Working directory
Placeholders changed by /meta-skills at copy time (NAME => {PLACEHOLDER}):
IS_GLOBAL => {IS_GLOBAL} TYPE_OF_AI_TOOLS => {TYPE_OF_AI_TOOLS} SKILL_PATH => {SKILL_PATH}
Bash / zsh:
export CURRENT_SKILL_DIRECTORY="{SKILL_PATH}"
~/.meta-skills/.venv/bin/python ~/.meta-skills/skills/productivity/video-conf/fathom/scripts/fetch.py --list
PowerShell (Windows):
$env:CURRENT_SKILL_DIRECTORY = "{SKILL_PATH}"
& "$HOME/.meta-skills/.venv/Scripts/python.exe" "$HOME/.meta-skills/skills/productivity/video-conf/fathom/scripts/fetch.py" --list
END TO COPY
fathom — Fathom meeting fetcher
Fetches meeting data directly from the Fathom API: transcripts, AI summaries, action items, participant info, and (optionally) the video recording.
When to use
Trigger phrases: "get my Fathom meetings", "sync meeting transcripts", "fetch today's calls", "download Fathom recording", /fathom_list, /fathom_today, /fathom_since, /fathom_get.
scripts/skill_env.py resolves .env via SkillCred — scripts call ENV.read_env() / ENV.get_secured_env() in-process (no source .env in the shell).
Library scripts: ~/.meta-skills/skills/productivity/video-conf/fathom/.
First Python run from the library skill folder:
cd ~/.meta-skills/skills/productivity/video-conf/fathom
~/.meta-skills/install.sh pip init .
Credentials — SkillCred .env
| Variable | Notes |
|---|---|
FATHOM_API_KEY |
From Fathom Settings → API |
OUTPUT_DIR |
Optional — default output for standalone download_video.py |
cp ~/.meta-skills/skills/productivity/video-conf/fathom/.env.example "{SKILL_PATH}/.env"
Slash commands
| Slash | CLI | Description |
|---|---|---|
/fathom_list |
python scripts/fetch.py --list |
List recent meetings |
/fathom_today |
python scripts/fetch.py --today |
Fetch today's meetings |
/fathom_since |
python scripts/fetch.py --since YYYY-MM-DD |
Fetch since a date |
/fathom_get |
python scripts/fetch.py --id RECORDING_ID |
Fetch a specific meeting |
Examples
export CURRENT_SKILL_DIRECTORY="{SKILL_PATH}"
python scripts/fetch.py --list
python scripts/fetch.py --today
python scripts/fetch.py --today --analyze
python scripts/fetch.py --since 2025-01-01
python scripts/fetch.py --id abc123def456
python scripts/fetch.py --id abc123def456 --download-video
Output format
Each meeting is saved as markdown with YAML frontmatter:
---
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)
## Transcript
**Speaker Name**: What they said...
File naming: YYYYMMDD-meeting-title-slug.md.
Prerequisites
- Shared venv:
~/.meta-skills/install.sh pip init .from the skill folder (requests). - Video download (optional):
ffmpeg/ffprobeon PATH.
Integration
- transcript-analyzer:
--analyzeruns the analyzer on fetched transcripts (if installed attranscript-analyzer/under the skill dir). - download_video.py:
--download-videodownloads the recording (HLS → MP4) next to the meeting markdown.
Notes
- Never commit
.envorFATHOM_API_KEY. - API base:
https://api.fathom.ai/external/v1(rate limited ~60/min; client self-throttles). - Confirm with the user before destructive actions.