otter-agent-cli

Agent-native CLI + MCP server for the Otter.ai API. 31 commands across 8 groups — works as a terminal CLI for humans and an MCP server for AI agents.

Install

npm install -g otter-agent-cli

Auth

# Option 1: Environment variable (recommended for automation)
export OTTER_ACCESS_TOKEN=your_token_here

# Option 2: Save to config file
otter login --access-token your_token_here

# Verify
otter status

Generate your access token in Otter.ai: Enterprise Settings → API → Generate Token

Note: The Otter.ai public API is currently in beta and requires an Enterprise plan. Contact your Otter account manager for API access.

Usage

# List conversations (meeting transcripts)
otter conversations list --pretty

# Get a full transcript
otter conversations transcript <id>

# Get timestamped, speaker-attributed utterances
otter conversations utterances <id> --pretty

# Organize into folders
otter folders create --name "Q1 Planning"
otter conversations update <id> --folder-id <folder_id>

# Set up webhook for transcript-ready events
otter webhooks create \
  --url https://your-app.com/webhooks/otter \
  --events Conversation.processed

# List speakers
otter speakers list --pretty

# Workspace members
otter workspace members --pretty

MCP Server

Use as an MCP server for Claude, Cursor, or any MCP-compatible agent:

{
  "mcpServers": {
    "otter": {
      "command": "npx",
      "args": ["otter-agent-cli", "mcp"],
      "env": {
        "OTTER_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

# Start MCP server manually
otter mcp

Output Flags

All commands support:

--pretty              # formatted JSON
--quiet               # suppress output (exit code only)
--fields id,title     # dot-notation field filter
--access-token <tok>  # per-command token override

Commands

| Group | Commands | |-------|---------| | otter login/logout/status | Auth management | | otter conversations | list, get, create, update, delete, transcript, utterances, share | | otter speakers | list, get, create, update | | otter folders | list, get, create, update, delete | | otter groups | list, get, members | | otter workspace | info, members | | otter webhooks | list, get, create, update, delete | | otter mcp | Start MCP stdio server |

See AGENTS.md for the full agent reference with examples.

Environment Variables

| Variable | Description | |----------|-------------| | OTTER_ACCESS_TOKEN | Otter.ai OAuth access token | | OTTER_API_URL | Override base URL for enterprise instances |

License

MIT — Brandon Charleson