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:

json

{
  "skills": {
    "otter": {
      "env": {
        "OTTER_EMAIL": "you@company.com",
        "OTTER_PASSWORD": "your-password",
        "TWENTY_API_URL": "https://api.your-twenty.com",
        "TWENTY_API_TOKEN": "your-token"
      }
    }
  }
}

📋 Commands

List Recent Transcripts

bash

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

Get Full Transcript

bash

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

Search Transcripts

bash

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

Download Transcript

bash

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

Upload Audio for Transcription

bash

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

Get AI Summary

bash

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

Sync to Twenty CRM

bash

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:

bash

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

bash

clawdhub install otter