AccountsOS CLI

UK accounting for AI agents. Cards, bills, expenses, VAT, HMRC in one CLI.

npm install -g @thriveventurelabs/accountsos

Or one-liner:

curl -fsSL https://accounts-os.com/install.sh | bash

Quick start

# Sign up — returns API key, saved to ~/.accountsos/config.json
accountsos signup --email [email protected] --company "Acme Ltd"

# Read
accountsos balance
accountsos transactions list --from 2026-01-01
accountsos vat
accountsos deadlines

# Write
accountsos transactions create --description "Stripe fee" --amount 12.50

# Packaged agentic skills
accountsos skills list
accountsos skills run vat-readiness
accountsos skills run receipt-compliance

Output modes

The CLI auto-detects whether a human or agent is running it. When stdout is a TTY you get a readable table; when piped or with --json you get compact structured JSON optimised for agent context.

accountsos balance               # human table
accountsos balance --json        # compact JSON
echo "" | accountsos balance     # auto-JSON (no TTY)

JSON mode is ~3-5x more token-efficient than human output.

Auth

Three ways to provide the API key, in order of precedence:

1. --api-key flag
2. ACCOUNTSOS_API_KEY env var
3. ~/.accountsos/config.json (set via accountsos auth login <key>)

Get a key from the dashboard at https://accounts-os.com/settings?tab=api-keys or via accountsos signup.

Use in MCP / Agent SDK

The CLI wraps the same /api/mcp endpoint as the MCP server. Drop into any agent that can shell out — no SDK required.

import subprocess, json
result = subprocess.run(
    ["accountsos", "transactions", "list", "--json", "--limit", "10"],
    capture_output=True, text=True
)
data = json.loads(result.stdout)

Documentation

• Landing: https://accounts-os.com/for-agents
• API: https://accounts-os.com/api/mcp (Bearer auth)
• Self-signup: POST /api/agent-signup
• MCP server (Claude Desktop): @thriveventurelabs/accountsos-mcp

Licence

MIT