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: **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 __CODE_BLOCK_6__ ### Export all calls from last week __CODE_BLOCK_7__ ### Find calls mentioning a topic __CODE_BLOCK_8__ --- ## 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

Requires a publicly accessible HTTPS endpoint.