otter - SKILL.md Agent Skill

name: otter description: Otter.ai transcription CLI - list, search, download, and sync meeting transcripts to CRM. version: 1.0.0 author: dbhurley homepage: https://otter.ai metadata: clawdis: emoji: "🦦" requires: bins: ["python3", "uv"] env: - OTTER_EMAIL - OTTER_PASSWORD optionalEnv: - TWENTY_API_URL - TWENTY_API_TOKEN primaryEnv: OTTER_EMAIL

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": "you@company.com",
        "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