sync-calls

/sync-calls — Import Call Recordings

Fetch recent call recordings from your configured call recording provider, import transcripts, and save them as structured markdown files.

Usage

• /sync-calls — Fetch new calls since last sync
• /sync-calls --all — Show all recent calls (ignore last-sync marker)
• /sync-calls --id {recording_id} — Import a specific recording by ID

Prerequisites

• config/config.yaml with integrations.call_recording.provider set (e.g., fathom, fireflies, otter, grain)
• .env file with the API key (env var name from config.integrations.call_recording.api_key_env)

Supported Providers

Provider	API Base	Auth Header
fathom	https://api.fathom.ai/external/v1	X-Api-Key
fireflies	https://api.fireflies.ai/graphql	Authorization: Bearer
otter	Manual import (no API)	—
grain	Manual import (no API)	—

For providers without an API (otter, grain, etc.), the skill prompts the user to paste or drop a transcript file instead.

Instructions

Step 1: Load Config and State

Read in parallel:

• config/config.yaml -> integrations.call_recording section
• memory/call_sync.md (if exists) -> last sync timestamp and last imported recording ID

Extract:

• provider — which call recording tool (fathom, fireflies, otter, grain)
• api_key_env — name of the env var holding the API key
• api_base — API base URL (use default for known providers)

If call_recording.provider is not set or call_recording.enabled is false, tell the user: "No call recording provider configured. Run /setup to set one up, or add transcripts manually to my-context/call-transcripts/."

Step 2: Fetch Recent Calls

If provider is fathom:

curl -s -H "X-Api-Key: $API_KEY" \
  "https://api.fathom.ai/external/v1/meetings"

If provider is fireflies:

curl -s -X POST "https://api.fireflies.ai/graphql" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ transcripts { id title date duration organizer_email participants sentences { speaker_name text } } }"}'