Skip to content

SKILL.md

Latest commit

 

History

History
119 lines (95 loc) · 2.72 KB

SKILL.md

File metadata and controls

119 lines (95 loc) · 2.72 KB
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 optionalEnv primaryEnv
🦦
bins env
python3
uv
OTTER_EMAIL
OTTER_PASSWORD
TWENTY_API_URL
TWENTY_API_TOKEN
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