akahu-personal
Query personal transactional bank-account data — account lists, balances, settled/pending transactions, account-specific transaction history, and private JSON/CSV exports — from Akahu, a New Zealand o
SKILL.mdskills/akahu-personal/SKILL.md
GitHubAkahu Personal App
Goal
Fetch a user's own Akahu Personal App data through a small deterministic CLI, without committing tokens or financial exports.
Use this when
- The user has created an Akahu Personal App and supplied tokens out-of-band
- A task needs Akahu
/me, account balances, account metadata, or recent transactions - A workflow needs settled or pending transaction samples for analysis
- A workflow needs a local JSON/CSV export of personal NZ banking data
Privacy and safety
- Requires both
AKAHU_APP_TOKENandAKAHU_USER_TOKENin the environment. - Treat output as personal financial data. Save only to private paths and do not paste raw exports into issues, PRs, logs, or shared chats.
- Account numbers are redacted by default. Pass
--raw-account-numbersonly in a private environment. - CI smoke tests intentionally skip live API calls because this skill requires personal credentials and personal banking data.
CLI
export AKAHU_APP_TOKEN='app_token_...'
export AKAHU_USER_TOKEN='user_token_...'
python3 skills/akahu-personal/scripts/cli.py me --json
python3 skills/akahu-personal/scripts/cli.py accounts --json
python3 skills/akahu-personal/scripts/cli.py transactions --limit 20 --json
python3 skills/akahu-personal/scripts/cli.py endpoint /accounts/<account_id>/transactions/pending --json
python3 skills/akahu-personal/scripts/cli.py export --out-dir /private/akahu-export
Commands:
me [--json]- call/v1/meaccounts [--json] [--raw-account-numbers]- list accounts and balancestransactions [--limit N] [--start ISO] [--end ISO] [--json] [--raw-account-numbers]- recent settled transactionsendpoint PATH [--method METHOD] [--param key=value] [--data-json JSON] [--data-file FILE]- advanced escape hatch for documented Akahu paths if the Personal App token has permission; non-GET methods require--i-understand-this-can-mutateexport --out-dir DIR [--limit N] [--raw-account-numbers]- write private JSON exports with0600file permissions
Resources
- CLI:
scripts/cli.py - Smoke test:
scripts/smoke_test.py(intentional skip) - API notes:
references/api-notes.md