Your workspace, at the command line

A standalone command-line app that drives the same operations Ceum exposes over MCP — for the work that's faster typed than clicked, and the automation you'd rather script than repeat.

Install

Requires Node.js 22 or newer. Install it globally to get the ceum command:

npm install -g @ceum/cli

Or run it once, without installing:

npx @ceum/cli --help

Set it up

From install to your first command in under a minute.

  1. Install the CLI

    Install the package globally with npm (Node.js 22 or newer).

    npm install -g @ceum/cli
  2. Get an MCP token

    Sign in to Ceum and open Settings → MCP to create a token. The CLI authenticates with it — see the pricing page for which plans include MCP.

    Open Ceum
  3. Sign in

    Run the login command and paste your token when prompted. It is stored securely in your config.

    ceum auth login
  4. Verify

    Check that you are connected — this prints the active profile and endpoint.

    ceum auth status

Basic usage

Every resource follows the same noun-first grammar, with table, JSON, or CSV output ready to pipe.

List open tasks and pull out their titles with jq:

ceum tasks list --status open -o json | jq '.[].title'

Create a task in one line:

ceum tasks create --title "Ship v1" --status todo

Export every transaction to CSV:

ceum transactions list --all -o csv > all-transactions.csv

Run headless in CI with a token from the environment:

CEUM_TOKEN=ceum_… ceum invoices list

Your workspace, from the prompt

The same workspace as the web and mobile apps, driven by a predictable command grammar.

Noun-first commands

A predictable grammar — task list, time start, invoice new — for driving your workspace.

Made for scripts

Run commands non-interactively and wire Ceum into the automation you already have.

Output your way

Get results as a table, JSON, or CSV, ready to pipe into the next tool.

Bulk operations

Act on many records at once instead of clicking through them one by one.

MCP under the hood

The CLI is a thin client over the Model Context Protocol Ceum exposes to external tools.

Assistant-ready

The same operations power the in-app assistant, so scripting and asking share one surface.

Full workspace reach

Clients, projects, tasks, time, transactions, and invoices — all reachable from the prompt.

Documented commands

Every command carries built-in help, with a full reference in the Knowledge Base.

Automate the parts you repeat

Bring Ceum into your terminal and scripts, alongside the web and mobile apps that share the same workspace.