{"skill":{"slug":"fathom","displayName":"Fathom","summary":"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.","description":"---\nname: fathom\ndescription: 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.\nread_when:\n  - User asks about their Fathom calls or meetings\n  - User wants to search call transcripts\n  - User needs a call summary or action items\n  - User wants to set up Fathom integration\nmetadata:\n  clawdbot:\n    emoji: \"📞\"\n    requires:\n      bins: [\"curl\", \"jq\"]\n---\n\n# Fathom Skill\n\nConnect to [Fathom AI](https://fathom.video) to fetch call recordings, transcripts, and summaries.\n\n## Setup\n\n### 1. Get Your API Key\n1. Go to [developers.fathom.ai](https://developers.fathom.ai)\n2. Create an API key\n3. Copy the key (format: `v1XDx...`)\n\n### 2. Configure\n```bash\n# Option A: Store in file (recommended)\necho \"YOUR_API_KEY\" > ~/.fathom_api_key\nchmod 600 ~/.fathom_api_key\n\n# Option B: Environment variable\nexport FATHOM_API_KEY=\"YOUR_API_KEY\"\n```\n\n### 3. Test Connection\n```bash\n./scripts/setup.sh\n```\n\n---\n\n## Commands\n\n### List Recent Calls\n```bash\n./scripts/list-calls.sh                    # Last 10 calls\n./scripts/list-calls.sh --limit 20         # Last 20 calls\n./scripts/list-calls.sh --after 2026-01-01 # Calls after date\n./scripts/list-calls.sh --json             # Raw JSON output\n```\n\n### Get Transcript\n```bash\n./scripts/get-transcript.sh 123456789      # By recording ID\n./scripts/get-transcript.sh 123456789 --json\n./scripts/get-transcript.sh 123456789 --text-only\n```\n\n### Get Summary\n```bash\n./scripts/get-summary.sh 123456789         # By recording ID\n./scripts/get-summary.sh 123456789 --json\n```\n\n### Search Calls\n```bash\n./scripts/search-calls.sh \"product launch\" # Search transcripts\n./scripts/search-calls.sh --speaker \"Lucas\"\n./scripts/search-calls.sh --after 2026-01-01 --before 2026-01-15\n```\n\n---\n\n## API Reference\n\n| Endpoint | Method | Description |\n|----------|--------|-------------|\n| `/meetings` | GET | List meetings with filters |\n| `/recordings/{id}/transcript` | GET | Full transcript with speakers |\n| `/recordings/{id}/summary` | GET | AI summary + action items |\n| `/webhooks` | POST | Register webhook for auto-sync |\n\n**Base URL:** `https://api.fathom.ai/external/v1`  \n**Auth:** `X-API-Key` header\n\n---\n\n## Filters for list-calls\n\n| Filter | Description | Example |\n|--------|-------------|---------|\n| `--limit N` | Number of results | `--limit 20` |\n| `--after DATE` | Calls after date | `--after 2026-01-01` |\n| `--before DATE` | Calls before date | `--before 2026-01-15` |\n| `--cursor TOKEN` | Pagination cursor | `--cursor eyJo...` |\n\n---\n\n## Output Formats\n\n| Flag | Description |\n|------|-------------|\n| `--json` | Raw JSON from API |\n| `--table` | Formatted table (default for lists) |\n| `--text-only` | Plain text (transcripts only) |\n\n---\n\n## Examples\n\n### Get your last call's summary\n```bash\n# Get latest call ID\nCALL_ID=$(./scripts/list-calls.sh --limit 1 --json | jq -r '.[0].recording_id')\n\n# Get summary\n./scripts/get-summary.sh $CALL_ID\n```\n\n### Export all calls from last week\n```bash\n./scripts/list-calls.sh --after $(date -d '7 days ago' +%Y-%m-%d) --json > last_week_calls.json\n```\n\n### Find calls mentioning a topic\n```bash\n./scripts/search-calls.sh \"quarterly review\"\n```\n\n---\n\n## Troubleshooting\n\n| Error | Solution |\n|-------|----------|\n| \"No API key found\" | Run setup or set `FATHOM_API_KEY` |\n| \"401 Unauthorized\" | Check API key is valid |\n| \"429 Rate Limited\" | Wait and retry |\n| \"Recording not found\" | Verify recording ID exists |\n\n---\n\n## Webhook Setup (Advanced)\n\nFor automatic transcript ingestion, see the webhook setup guide:\n```bash\n./scripts/setup-webhook.sh --url https://your-endpoint.com/webhook\n```\n\nRequires a publicly accessible HTTPS endpoint.\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":3108,"installsAllTime":117,"installsCurrent":19,"stars":1,"versions":1},"createdAt":1768322071307,"updatedAt":1779144840625},"latestVersion":{"version":"1.0.0","createdAt":1768322071307,"changelog":"Initial release - Connect to Fathom AI for call transcripts and summaries","license":null},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"lucassynnott","userId":"s1746capq67245t469qmyp8rn1884zvr","displayName":"Lucas Synnott","image":"https://avatars.githubusercontent.com/u/3947311?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779913414276}}