🪙 simplefin-cli

A CLI tool for accessing financial data via SimpleFIN Bridge.

✨ Why simplefin-cli?

SimpleFIN Bridge provides a secure way to access financial data. simplefin-cli gives you full command-line access without a GUI.

✅ Non-interactive (100% automatable) ✅ Cross-platform (Linux, macOS, Windows) ✅ Full SimpleFIN protocol support ✅ JSON output for scripting

🚀 Installation

npm install -g @dilllxd/simplefin-cli

💡 Quick Start

# Connect with a setup token
simplefin connect --token YOUR_SETUP_TOKEN

# List accounts
simplefin accounts

# View transactions
simplefin transactions

# Get transactions as JSON
simplefin transactions --json

Get a setup token at https://beta-bridge.simplefin.org/my-account/tokens/create

📖 Commands

simplefin connect

Connect to SimpleFIN Bridge using a setup token.

simplefin connect --token <setup-token>

Token can also be provided via SIMPLEFIN_SETUP_TOKEN environment variable.

simplefin disconnect

Remove saved credentials.

simplefin disconnect

simplefin status

Check connection status.

simplefin status
simplefin status --json

simplefin accounts

List connected accounts.

simplefin accounts
simplefin accounts --json
simplefin accounts --balances-only

simplefin transactions

List transactions.

simplefin transactions                        # Last 30 days
simplefin transactions --days 7               # Last 7 days
simplefin transactions --json                 # JSON output
simplefin transactions --start-date 2026-01-01
simplefin transactions --end-date 2026-01-31
simplefin transactions --account ACT-12345
simplefin transactions --pending

simplefin info

Show server information.

simplefin info
simplefin info --json

🔧 Configuration

Credentials stored in OS-appropriate location:

| OS | Location | |---|---| | Linux | ~/.config/simplefin-cli/connection.json | | macOS | ~/Library/Application Support/simplefin-cli/ | | Windows | %APPDATA%\simplefin-cli\ |

🧱 Project Structure

simplefin-cli/
├── bin/
│   └── simplefin.js    # Main CLI entry point
├── LICENSE
├── package.json
└── README.md

🪪 License

MIT