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.