Mnie
Return to top
On this page

Finance, piped

The Mnie CLI turns the same typed finance surface into JSON-friendly terminal commands. Use it from a shell, a script, or an agent without building another integration layer.

Connect

Save a server origin and API key as a named profile.

bash
mnie profile add local \
  --origin https://mnie.example.com \
  --api-key "$MNIE_API_KEY" \
  --storage keyring

Origins must not include a path. Use --storage keyring to keep the API key in the platform keyring, or --storage file to store it in ~/.mnie-cli/profiles.json with mode 0600.

bash
mnie profile list
mnie profile use local

Login

OAuth login opens an approval page and stores the resulting access token as a profile.

bash
mnie login \
  --origin https://mnie.example.com \
  --profile local \
  --storage keyring

The CLI uses Authorization Code with PKCE and receives the callback on a temporary localhost port.

Call

Inspect the methods exposed by the connected Mnie server.

bash
mnie rpc methods --profile local

Call a method with its parameters as one JSON argument.

bash
mnie rpc call market.issue.board \
  '{"issueCode":"7203","market":"T"}' \
  --profile local \
  --provider sbisec --profile-id sbi_xxx

Output is formatted JSON, so it can be inspected directly or passed to another process.

bash
mnie rpc call account.positions.cash \
  --profile local \
  --provider sbisec --profile-id sbi_xxx \
  | jq

PROFILE FIRST

Omit --profile after selecting a default with mnie profile use. Keep it explicit in automation when multiple environments exist.

Export Beancount

Export posted money transactions for a date range as standard Beancount plaintext.

text
mnie export beancount --from <YYYY-MM-DD> --to <YYYY-MM-DD> [--profile <name>] [--profile-id <id>]
bash
mnie export beancount \
  --from 2026-01-01 \
  --to 2026-06-30 \
  --profile local \
  > main.bean

All financial profiles are included unless --profile-id is supplied. Source accounts are derived under Assets:Mnie, uncategorized counterpart accounts balance each entry, and metadata preserves the Mnie transaction, profile, and kind IDs. Unsupported, non-posted, or non-money transactions fail the command instead of producing a partial ledger.

Trade

Read operations can be called directly. Live placement, correction, and cancellation require explicit trading permission in their JSON parameters.

json
{
  "allowTrading": true
}

DELIBERATE ACTION

Only include allowTrading: true after the exact live order has been reviewed and confirmed. Estimation methods should be preferred before submission.

Commands

text
mnie --help
mnie profile add <name> --origin <origin> --api-key <key>
mnie profile list
mnie profile use <name>
mnie login --origin <origin>
mnie rpc methods
mnie rpc call <method> [json-params]
mnie export beancount --from <YYYY-MM-DD> --to <YYYY-MM-DD> [--profile <name>] [--profile-id <id>]