Fathom Skill

Connect to Fathom AI to fetch call recordings, transcripts, and summaries.

Setup

1. Get Your API Key

Go to developers.fathom.ai
Create an API key
Copy the key (format: v1XDx...)

2. Configure

# 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

./scripts/setup.sh

Commands

List Recent Calls

./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

./scripts/get-transcript.sh 123456789      # By recording ID
./scripts/get-transcript.sh 123456789 --json
./scripts/get-transcript.sh 123456789 --text-only

Get Summary

./scripts/get-summary.sh 123456789         # By recording ID
./scripts/get-summary.sh 123456789 --json

Search Calls

./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}/transcript | GET | Full transcript with speakers | | /recordings/{id}/summary | GET | AI summary + action items | | /webhooks | POST | Register webhook for auto-sync |

Base URL: https://api.fathom.ai/external/v1
Auth: X-API-Key header

Filters for list-calls

| Filter | Description | Example | |--------|-------------|---------| | --limit N | Number of results | --limit 20 | | --after DATE | Calls after date | --after 2026-01-01 | | --before DATE | Calls before date | --before 2026-01-15 | | --cursor TOKEN | Pagination cursor | --cursor eyJo... |

Output Formats

| Flag | Description | |------|-------------| | --json | Raw JSON from API | | --table | Formatted table (default for lists) | | --text-only | Plain text (transcripts only) |

Examples

Get your last call's summary

# Get latest call ID
CALL_ID=$(./scripts/list-calls.sh --limit 1 --json | jq -r '.[0].recording_id')

# Get summary
./scripts/get-summary.sh $CALL_ID

Export all calls from last week

./scripts/list-calls.sh --after $(date -d '7 days ago' +%Y-%m-%d) --json > last_week_calls.json

Find calls mentioning a topic

./scripts/search-calls.sh "quarterly review"

Troubleshooting

| Error | Solution | |-------|----------| | "No API key found" | Run setup or set FATHOM_API_KEY | | "401 Unauthorized" | Check API key is valid | | "429 Rate Limited" | Wait and retry | | "Recording not found" | Verify recording ID exists |

Webhook Setup (Advanced)

For automatic transcript ingestion, see the webhook setup guide:

./scripts/setup-webhook.sh --url https://your-endpoint.com/webhook

Requires a publicly accessible HTTPS endpoint.