CLI Tool - Moneda Docs

The Moneda CLI lets you interact with your Moneda account directly from the terminal. Check balances, browse transactions, send payments, and more — all without leaving the command line.

The API, MCP server and CLI are available on every plan today. If that changes for your plan, these surfaces return 403 PLAN_UPGRADE_REQUIRED and the message names the plans that include them.

Installation

Install the CLI globally with npm:

npm install -g @moneda/cli

Verify the installation:

moneda --version

Quick start

moneda auth login

This opens your browser for OAuth authentication. Approve the permissions, and the CLI stores a token locally. Confirm it worked before running anything else:

moneda auth status

This prints the account the token belongs to and when it expires. If it says you’re not connected, the login did not complete — run moneda auth login again.

Every command below needs that token. Without a completed login the CLI exits with a missing-auth-token error. If you’d rather not log in interactively — CI, a cron job, a script — use an API key instead: moneda <command> --api-key mnd_.... See Authentication.

Check your balance:

moneda account balance

List recent transactions:

moneda transaction list --limit 5

Global flags

These flags work with any command:

Flag	Description
`-o, --output <format>`	Output format: `text` (default), `json`, `csv`, `markdown`, or `toon`
`--api-url <url>`	Override the API base URL (default: `https://rest.moneda.com`) — the CLI appends `/v1` itself, so don’t include it
`--auth-url <url>`	Override the auth server used by `moneda auth login` (default: `https://id.moneda.com`)
`--api-key <key>`	Use an API key instead of OAuth (overrides the stored Bearer token)
`-d, --detail`	Return the full response shape (default is `?view=lite` — compact output for terminal rendering)
`-v, --verbose`	Show detailed request/response information
`-q, --quiet`	Suppress all output except errors

Use --output json to pipe CLI output into other tools like jq for scripting and automation. Use --output toon to see exactly what an LLM agent would consume from the same endpoint (~40% fewer tokens than JSON on array-heavy responses — handy when prototyping against @moneda/services’s agent tools).

Response shape: `--detail` flag

Every GET command defaults to ?view=lite — the REST API returns a compact shape optimised for terminal rendering (fewer columns, no UI coaching fields, no masked raw routing). Pass --detail when you need the full shape — typically when scripting with --output json and want every field the server exposes.

# Compact — one tidy row per transaction, no wrapping
moneda transaction list --limit 5

# Full — every field (typeGroup, category, note, reference, raw routing…)
moneda transaction list --limit 5 --detail --output json | jq

If a command’s output looks truncated, try --detail --output json to see everything.

What’s next?

CLI Authentication

Set up and manage your CLI credentials.

Command Reference

Browse all available CLI commands.

CLI Examples

Common workflows and scripting examples.

REST API

Use the REST API directly for deeper integrations.

​Installation

​Quick start

​Global flags

​Response shape: --detail flag

​What’s next?

CLI Authentication

Command Reference

CLI Examples

REST API

Installation

Quick start

Global flags

Response shape: `--detail` flag

What’s next?