otter

Otter.ai Transcription CLI

Interact with Otter.ai to manage meeting transcripts - list, search, download, upload, summarize, and sync to CRM.

🔑 Required Secrets

Variable	Description	How to Get
OTTER_EMAIL	Your Otter.ai account email	Your login email
OTTER_PASSWORD	Your Otter.ai password	Set in Otter account settings

🔐 Optional Secrets (for CRM sync)

Variable	Description	How to Get
TWENTY_API_URL	Twenty CRM API endpoint	Your Twenty instance URL
TWENTY_API_TOKEN	Twenty API key	Twenty → Settings → Developers → API Keys

⚙️ Setup

Configure in ~/.clawdis/clawdis.json:

{
  "skills": {
    "otter": {
      "env": {
        "OTTER_EMAIL": "[email protected]",
        "OTTER_PASSWORD": "your-password",
        "TWENTY_API_URL": "https://api.your-twenty.com",
        "TWENTY_API_TOKEN": "your-token"
      }
    }
  }
}

📋 Commands

List Recent Transcripts

uv run {baseDir}/scripts/otter.py list [--limit 10]

Get Full Transcript

uv run {baseDir}/scripts/otter.py get <speech_id>

Search Transcripts

uv run {baseDir}/scripts/otter.py search "quarterly review"

Download Transcript

uv run {baseDir}/scripts/otter.py download <speech_id> [--format txt|pdf|docx|srt]

Upload Audio for Transcription

uv run {baseDir}/scripts/otter.py upload /path/to/audio.mp3

Get AI Summary

uv run {baseDir}/scripts/otter.py summary <speech_id>

Sync to Twenty CRM

uv run {baseDir}/scripts/otter.py sync-twenty <speech_id>
uv run {baseDir}/scripts/otter.py sync-twenty <speech_id> --company "Client Name"

📤 Output Formats

All commands support --json for machine-readable output:

uv run {baseDir}/scripts/otter.py list --json

🔗 Twenty CRM Integration

When syncing to Twenty, creates:

• Note with transcript title, date, duration, and full text
• Auto-links to engagement if --company matches

⚠️ Notes

• Requires Otter.ai account (Business recommended for API access)
• Uses unofficial Otter.ai API
• SSO users: Create a password in Otter account settings
• Rate limits may apply

📦 Installation

clawdhub install otter