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.

Install the CLI

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

npm install -g @ceum/cli

Get an MCP token

Create a token under Settings → Integrations. The CLI authenticates with it — see the pricing page for which plans include MCP.

Open Settings → Integrations

Sign in

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

ceum auth login

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 the tasks in progress and pull out their names with jq:

ceum tasks list --status in-progress -o json | jq '.data[].name'

Create a task in one line:

ceum tasks create --name "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

What it looks like

Real output from a Ceum workspace: aligned tables on a terminal, and a command list derived from what your token can do.

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 resource-first grammar — tasks list, time-sessions start, invoices create — 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.

No credit card required