Skip to main content

Import statements from a folder automatically

The Finance Inbox agent runs on your own computer, watches the folders you give it, and sends each new statement file to the workspace to review. It never records anything itself.

All how-tos

  1. 1

    Create a token

    Settings → Connections, under Finance Inbox access tokens, for an administrator: Create a token takes a Name and, if you like, when it Expires (optional). Create token shows it once — Copy this token now. A token can only send statements for review; it can never record them.

  2. 2

    Download its configuration

    The agent works by rules, one for each folder it watches: which account its statements are sent to, which files it takes, what to do with a file once sent, and where a refused one is set aside. Under Agent configuration, tick the Accounts the agent may send statements to and Download agent configuration: inbox-agent.json, with this workspace's address and a rule for each account, its id written in. Replace each folder in it with a folder on your computer. The file holds no token. On a server, Agent configuration is shown once the installation's operator has set up the agent's route; until then the page says the installation does not receive statements from the agent yet. The desktop app shows neither.

  3. 3

    Set the agent up

    The agent runs on a Mac with Node 22, and comes from your installation's operator: it is not a public download. At the top of the copy the operator gives you, pnpm run inbox-agent:init --config /path/to/inbox-agent.json asks for the token at a hidden prompt and checks it with the workspace. The token is kept in the macOS Keychain, never in a file.

  4. 4

    Let it send what arrives

    pnpm run inbox-agent:scan sends what is new once; pnpm run inbox-agent:watch keeps looking. It sends a statement as the bank wrote it — a CSV, a spreadsheet, an OFX download, a CAMT or MT940 statement, QIF or Wise JSON — and a PDF or an image is set aside for now. A file sent stays where it is — or, when its rule says copy or move, a private copy is kept in an archive folder and the original stays where it was; a file refused is set aside in its rule's folder for that.

  5. 5

    Review what it sent

    Each file sent waits in Inbox → Statement imports, to be reviewed and posted like a statement uploaded by hand. The same file sent again is recognised and not staged twice.

    See also: Bank accounts, statements and receipts

  6. 6

    Revoke a token

    Revoke on a token refuses the agent from its next request, and cannot be undone. To carry on, create a new token and run inbox-agent:init again.