Unofficial CLI client for Meu Dinheiro - a Brazilian personal finance app.
Requires Bun. mdcli runs TypeScript directly and relies on Bun-only APIs, so it does not run under plain Node.js.
bun install -g github:fm1randa/mdcligh repo clone fm1randa/mdcli
cd mdcli
bun install
bun dev --helpFor automatic login when browser session extraction fails, install the 1Password CLI:
# macOS
brew install 1password-cli
# Linux# See https://developer.1password.com/docs/cli/get-started/#installCreate a 1Password item with the following fields:
username- your login emailpassword- your passwordotp- one-time password (configured as TOTP)
If the login page shows a reCAPTCHA challenge, you can configure a 2Captcha API key to automatically solve it:
mdcli auth login --captcha-key <your-2captcha-api-key>The API key is saved to config and reused for future logins.
The CLI supports multiple authentication methods:
If you're already logged into MeuDinheiro in your browser, the CLI can extract your session automatically:
# Extracts session from Chrome (default)
mdcli auth login
# Explicitly use Chrome
mdcli auth login --session chrome
# Use Firefox instead
mdcli auth login --session firefoxIf session extraction fails (e.g., not logged in, browser not found), you'll be prompted with fallback options:
- Use 1Password for automatic login
- Try Firefox session instead
- Open browser for manual login
- Enter credentials manually
- Cancel
# Use 1Password item (prompts for item name on first run)
mdcli auth login --item
# Specify item name directly
mdcli auth login --item "My Meu Dinheiro"Opens a browser for you to log in manually:
mdcli auth login --browsermdcli auth statusShows your authentication status including the method used (Browser session, 1Password, etc.).
# Remove the stored session
mdcli auth logout# Also clear the saved 1Password item and 2Captcha key
mdcli auth logout --all--account, --category, and --tag accept three forms, tried in this order:
- Numeric ID — e.g.
--account 1167419. Fastest, no network needed. - Alias — a short name you've mapped to an ID via
mdcli accounts alias add. Stored locally in~/.config/mdcli/mdcli.config.json. - Exact name — the entity's real name as shown by
mdcli accounts list, matched case-insensitively. Names are looked up via a 30-day on-disk cache and auto-invalidated when a request using a cached ID returns a non-2xx.
Aliases win over names when both match the same string, so your shortcuts always take priority.
# Authenticate (extracts session from Chrome by default)
mdcli auth login
# Or use 1Password
mdcli auth login --item "My Meu Dinheiro"# List accounts
mdcli accounts list --active
# Create an alias for quick access
mdcli accounts alias add --id 1167419 --name mp
# List entries using alias
mdcli entries list --account mp --from 2024-01-01 --to 2024-01-31
# List entries using the account's exact name (case-insensitive)
mdcli entries list --account "Nubank - Conta Corrente" --from 2024-01-01 --to 2024-01-31
# Create an entry
mdcli entries create --account mp --description "Groceries" --value 150 --category food
# Create an entry using the account name instead of an alias
mdcli entries create --account "Mercado Pago" --description "Groceries" --value 150 --category food
# Update an entry (only the fields you pass are changed)
mdcli entries update 12345 --value 200 --category food
# Delete an entry
mdcli entries delete 12345
# List credit cards
mdcli cards list --active
# Show a credit card invoice (defaults to the current/next one)
mdcli cards invoice --account <cardId> --month 2026-02
# Show a credit card invoice using the card's exact name
mdcli cards invoice --account "Itaú Personalité" --month 2026-02
# Show upcoming installments on a card
mdcli cards future --account <cardId># Create a tag (color is optional, defaults to gray)
mdcli tags create --name "Travel" --color "#FF6600"# Update a tag (only the fields you pass are changed)
mdcli tags update 12345 --color "#00AAFF"# Archive (deactivate) or reactivate a tag
mdcli tags update 12345 --inactive
mdcli tags update 12345 --active
# Delete a tag
mdcli tags delete 12345| Feature | Status |
|---|---|
| Browser session extraction (Chrome/Firefox) | Done |
| Browser login (auto-capture) | Done |
| Automatic login (1Password CLI) | Done |
| Auto token refresh on 401 | Done |
| Manual token entry | Done |
| Status check | Done |
| Logout | Done |
| Feature | Status |
|---|---|
| List | Done |
| Filter by active | Done |
| JSON output | Done |
| Aliases (add/list/rm/update) | Done |
| Create | Missing |
| Update | Missing |
| Delete | Missing |
| Archive | Missing |
| Feature | Status |
|---|---|
| List | Done |
| Filter by active | Done |
| Filter by type | Missing |
| JSON output | Done |
| Aliases (add/list/rm/update) | Done |
| Create | Missing |
| Update | Missing |
| Delete | Missing |
| Archive | Missing |
| Feature | Status |
|---|---|
| List | Done |
| Filter by active | Done |
| JSON output | Done |
| Aliases (add/list/rm/update) | Done |
| Create | Done |
| Update | Done |
| Delete | Done |
| Archive | Done |
| Feature | Status |
|---|---|
| List by account | Done |
| Filter by date range | Done |
| Filter by status | Done |
| Filter by type | Done |
| Filter by category | Done |
| Filter by tag | Done |
| Filter by keywords | Done |
| Filter by value | Done |
| JSON output | Done |
| Alias support (account/category/tag) | Done |
| Create (single) | Done |
| Create (recurring) | Done |
| Update | Done |
| Delete | Done |
| Feature | Status |
|---|---|
| List | Done |
| Filter by active | Done |
| JSON output | Done |
| Invoice (by month) | Done |
| Future installments | Done |