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