fathom

---
name: fathom
description: Connect to Fathom AI to fetch call recordings, transcripts, and summaries. Use when user asks about their meetings, call history, or wants to search past conversations.
read_when:
  - User asks about their Fathom calls or meetings
  - User wants to search call transcripts
  - User needs a call summary or action items
  - User wants to set up Fathom integration
metadata:
  clawdbot:
    emoji: "📞"
    requires:
      bins: ["curl", "jq"]
---

# Fathom Skill

Connect to [Fathom AI](https://fathom.video) to fetch call recordings, transcripts, and summaries.

## Setup

### 1. Get Your API Key
1. Go to [developers.fathom.ai](https://developers.fathom.ai)
2. Create an API key
3. Copy the key (format: `v1XDx...`)

### 2. Configure
```bash
# Option A: Store in file (recommended)
echo "YOUR_API_KEY" > ~/.fathom_api_key
chmod 600 ~/.fathom_api_key

# Option B: Environment variable
export FATHOM_API_KEY="YOUR_API_KEY"
```

### 3. Test Connection
```bash
./scripts/setup.sh
```

---

## Commands

### List Recent Calls
```bash
./scripts/list-calls.sh                    # Last 10 calls
./scripts/list-calls.sh --limit 20         # Last 20 calls
./scripts/list-calls.sh --after 2026-01-01 # Calls after date
./scripts/list-calls.sh --json             # Raw JSON output
```

### Get Transcript
```bash
./scripts/get-transcript.sh 123456789      # By recording ID
./scripts/get-transcript.sh 123456789 --json
./scripts/get-transcript.sh 123456789 --text-only
```

### Get Summary
```bash
./scripts/get-summary.sh 123456789         # By recording ID
./scripts/get-summary.sh 123456789 --json
```

### Search Calls
```bash
./scripts/search-calls.sh "product launch" # Search transcripts
./scripts/search-calls.sh --speaker "Lucas"
./scripts/search-calls.sh --after 2026-01-01 --before 2026-01-15
```

---

## API Reference

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/meetings` | GET | List meetings with filters |
| `/recordings/{id}/trans