Kobbe CLI

Kobbe CLI gives you terminal and MCP access to your Kobbe analytics workspace.

Install

npm install -g @kobbe/cli

Login

Create a personal access token in Kobbe under Account -> Agent access, then run:

kobbe login --token kbpat_...

You can also avoid writing config by using environment variables:

KOBBE_TOKEN=kbpat_... kobbe sites

CLI Commands

kobbe me
kobbe sites
kobbe overview --site site_x --range today
kobbe revenue --site site_x --range today
kobbe top-pages --site site_x --range today --limit 5
kobbe sources --site site_x --range today --limit 5
kobbe next --site site_x --range today
kobbe setup-health --site site_x

Management commands require write scopes:

kobbe create-site --name "My site" --domain example.com
kobbe update-site --site site_x --name "New name"
kobbe rotate-token --site site_x
kobbe delete-site --site site_x --confirm "DELETE example.com"
kobbe reset-stats --site site_x --confirm "RESET example.com"

Use --json for raw API responses, or --plain for human output without symbols.

MCP

Add this server to your MCP client:

{
  "mcpServers": {
    "kobbe": {
      "command": "kobbe",
      "args": ["mcp"]
    }
  }
}

For local development:

{
  "mcpServers": {
    "kobbe": {
      "command": "node",
      "args": [
        "/path/to/app.kobbe.io/packages/kobbe-cli/src/cli.js",
        "mcp"
      ]
    }
  }
}