mcpField
F
fathom

fathom

github.com/glebisProductivity401245 installsUpdated 1d ago
Repository

About fathom

fathom fetches meeting data from the Fathom API, including transcripts, AI summaries, action items, and participant details. It is for organizing meeting records, with optional transcript analysis and video downloads.

Key features

  1. 01Fetch meetings by date or ID
  2. 02Save transcripts, summaries, and action items
  3. 03Store meeting data as Markdown
  4. 04Optionally analyze transcripts or download video

Use cases

  1. 01Collect meetings from today or a chosen date
  2. 02Retrieve and organize data for a specific recording
  3. 03Download a meeting video alongside its notes

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/glebis/claude-skills --skill fathom

After installing, type/fathomin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.claude-plugin/
plugin.json
scripts/
.env.example
download_video.py
fetch.py
utils.py

Details

From the project README

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
CommandDescription
--listList recent meetings with IDs
--id <id>Fetch specific meeting by recording ID
--todayFetch all meetings from today
--since <date>Fetch meetings since date (YYYY-MM-DD)
Options
OptionDescription
--analyzeRun transcript-analyzer on fetched meetings
--download-videoDownload 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 --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)

Comments

Markdown supported