@blaze-money/cli

Give your AI agent the ability to manage payments, analyze spending, and automate financial operations.

What You Can Do

You:   "How much did I spend on Brex this month?"
Agent: You spent $2,720.45 on Brex across 2 transactions (May 1–27).

You:   "Pay all bills due this week"
Agent: 3 bills due by Friday totaling $3,478.17. Fees: $4.50. Confirm? → Paid.

You:   "Send $500 to @maria"
Agent: Sent $500 USD to Maria Santos. Transfer ID: txn_xyz789.

You:   "Create a payment link for $2,000 — client invoice"
Agent: Created: https://pay.blaze.money/links/lnk_abc123

Quick Start

npm install -g @blaze-money/cli
blaze auth
blaze businesses use        # select your business (if you have one)

Add to Claude Code

claude mcp add blaze -- npx -y @blaze-money/cli mcp
claude skill add $(npm root -g)/@blaze-money/cli/skills/blaze

Done. Ask your agent anything about your finances.

Add to Codex

codex --full-auto --mcp-config '{"blaze":{"command":"npx","args":["-y","@blaze-money/cli","mcp"]}}'

Other AI Environments

The Blaze skill ships with the CLI package. For environments that support skills, install with:

claude skill add $(npm root -g)/@blaze-money/cli/skills/blaze

For environments that only support MCP servers, add this config:

{
  "command": "npx",
  "args": ["-y", "@blaze-money/cli", "mcp"]
}

No API key needed — the server uses your blaze auth session.

{
  "mcpServers": {
    "blaze": {
      "command": "npx",
      "args": ["-y", "@blaze-money/cli", "mcp"]
    }
  }
}

{
  "blaze": {
    "command": "npx",
    "args": ["-y", "@blaze-money/cli", "mcp"]
  }
}

CLI

A complete command-line interface for your Blaze account.

blaze balance                    # Check account balance
blaze transactions list          # View recent transactions
blaze transactions list --personal  # Personal transactions
blaze businesses list            # List your businesses
blaze businesses use <id>        # Switch business context

Context Flags

--personal      # Force personal mode (ignore active business)
--business <id> # Use a specific business for one command
--format json   # Raw JSON output (default: table)

See docs/cli.md for the full command reference.

Staying Up to Date

The CLI checks npm for a newer version in the background (at most once a day). When one is available, it asks you on startup whether you'd like to update:

✨ Blaze CLI v1.3.0 is available — you're on v1.2.0
? Update now? (y/N)

Answer y and the CLI runs npm i -g @blaze-money/cli@latest for you (with a spinner), then exits so you can re-run your command on the new version. Answer N (the default — just hit Enter) and it remembers your choice, so it won't ask again until an even newer version ships. If the update can't complete (e.g. a permissions error), it prints the manual command and lets your original command run.

The registry check runs in a detached background process, so it never slows down your command. The prompt only appears in an interactive terminal and is automatically suppressed for non-interactive use (piped output, --format json, CI), on fast paths (--version, --help, mcp), and when stdin isn't a TTY (a passive one-line notice is shown instead). To opt out entirely, set NO_UPDATE_NOTIFIER=1.

Authentication

blaze auth          # Browser login (recommended)
blaze auth login --api-key sk_live_...  # API key (CI/headless)

Your session persists across CLI and MCP — authenticate once, use everywhere.

Supported Currencies

USD, MXN, EUR, GBP, BRL, COP, PEN, ARS — with real-time FX rates between all pairs.

Documentation

Contributing

We welcome contributions. See CONTRIBUTING.md for guidelines.

License

MIT — see LICENSE for details.