Roster

Query your team's work from the terminal, or straight from Claude. A small CLI and MCP server for Roster. No app, no SQL.

$ brello stats
team size: 7
open: 24   done: 37   overdue: 5
active now: 2

Install

npm install -g brello

Then sign in — paste the token your admin gave you (saved, so you only do it once):

brello auth
brello stats

Need a token? Ask your admin to issue one. The command is brello (typing roster works too).

git clone https://github.com/brickshubkuwait/roster-cli-mcp.git
cd roster-cli-mcp && npm install && npm link
brello auth

CLI

Run brello help to see them all. Full reference: QUERIES.md.

Limits

Each call returns a sensible page: search up to 50 cards, comments / reactions the latest 40, leaves the next 60 upcoming.

Use it from Claude (MCP)

The global install also adds a brello-mcp command. If you've run brello auth, Claude reuses that sign-in — just add this to ~/.claude.json and ask in plain English ("what's overdue for my team?", "who's off next week?"):

{
  "mcpServers": {
    "brello": {
      "command": "brello-mcp"
    }
  }
}

No path, no token — the server reads the one brello auth saved. To pin a specific token, add "env": { "BRELLO_TOKEN": "..." }.