finta brings Finta’s REST API to your terminal. Every API endpoint is a command.
Install
- macOS and Linux
- Homebrew
- npm (Windows)
finta tells you when a newer version is out.
Sign in
--no-openprints the sign-in link instead of opening a browser.--with-api-keysigns in with an API key instead. In CI, setFINTA_API_KEY.finta whoamishows the company you’re signed in to.finta logoutsigns out.
finta signups create --email you@company.com, click Activate in the email, run finta login, then finta onboarding retrieve to finish setting up.
Commands
Each command is an API resource and an action:GET /transactions is finta transactions list. Run finta --help to see them all, and --help on any command for its flags.
--allfetches every page of a list.-d, --datasends a JSON body, for nested fields.--dry-runprints the request without sending it.finta api <method> <path>calls any API path, such asfinta api GET "/transactions?limit=5".finta exportsaves a report as a PDF, CSV or XLSX file, andfinta uploadimports transactions from a CSV.
finta.
Output
In a terminal, lists print as tables. When output is piped, or with--json, you get the API’s JSON:
Confirmations
Deletes and other changes that can’t be undone ask before they run. In a script or agent, pass--yes to confirm.
Exit codes
If a change times out,
finta doesn’t retry it. It tells you the command to check whether it went through.
Coding agents
Coding agents like Claude Code, Codex and Cursor can runfinta directly: they get JSON output and --help for every command. They should pass --yes only after you approve a change. To connect an AI app like Claude or ChatGPT instead, use the MCP server.