NZ Open Banking MCP (Akahu)
Ask about your New Zealand bank accounts through Akahu, read-only unless you allow writes
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.1.7
- Listing updated
- 3 days ago
About NZ Open Banking MCP (Akahu)
NZ Open Banking MCP (Akahu) is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
This server wraps Akahu, the New Zealand open-finance service, using a Personal App you create at my.akahu.nz/developers. It runs on your own machine over stdio and talks only to api.akahu.io. The README says tokens and transaction contents are never logged. It is unofficial and not affiliated with Akahu or any bank.
Fourteen tools are exposed. Ten read: accounts, balances, settled and pending transactions, a text search with a default 90-day window, and the user profile. Four write: refreshing one or all accounts, reporting a transaction issue to Akahu and verifying a name, which needs an extra scope and may be charged per call. Writes are refused until AKAHU_READ_ONLY=false, and each one then asks for consent showing what will be sent.
There are no built-in reports, budgets or forecasts; the assistant derives those from the transactions. Setting AKAHU_MASK_ACCOUNTS=true shows only the bank code, last four digits and suffix. It installs as plugins for Claude Code, Codex, Cursor and Grok Build, a Claude Desktop extension, or uvx.
Install
Run in a terminal
claude mcp add nz-openbank-mcp --env AKAHU_USER_TOKEN='<AKAHU_USER_TOKEN>' --env AKAHU_APP_TOKEN='<AKAHU_APP_TOKEN>' -- uvx nz-openbank-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"nz-openbank-mcp": {
"command": "uvx",
"args": [
"nz-openbank-mcp"
],
"env": {
"AKAHU_USER_TOKEN": "<AKAHU_USER_TOKEN>",
"AKAHU_APP_TOKEN": "<AKAHU_APP_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"nz-openbank-mcp": {
"command": "uvx",
"args": [
"nz-openbank-mcp"
],
"env": {
"AKAHU_USER_TOKEN": "<AKAHU_USER_TOKEN>",
"AKAHU_APP_TOKEN": "<AKAHU_APP_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"nz-openbank-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"nz-openbank-mcp"
],
"env": {
"AKAHU_USER_TOKEN": "<AKAHU_USER_TOKEN>",
"AKAHU_APP_TOKEN": "<AKAHU_APP_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"nz-openbank-mcp": {
"command": "uvx",
"args": [
"nz-openbank-mcp"
],
"env": {
"AKAHU_USER_TOKEN": "<AKAHU_USER_TOKEN>",
"AKAHU_APP_TOKEN": "<AKAHU_APP_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"nz-openbank-mcp": {
"command": "uvx",
"args": [
"nz-openbank-mcp"
],
"env": {
"AKAHU_USER_TOKEN": "<AKAHU_USER_TOKEN>",
"AKAHU_APP_TOKEN": "<AKAHU_APP_TOKEN>"
}
}
}
}Configuration
AKAHU_USER_TOKENUser token from https://my.akahu.nz/developers.RequiredAKAHU_APP_TOKENApp token from https://my.akahu.nz/developers.RequiredAKAHU_READ_ONLYRefuse all write tools when 'true'. Leave as 'true' unless you specifically need refresh/verify/report writes.AKAHU_AUTOMATION_BYPASSSkip per-call consent prompts for safe-to-automate writes (account refresh only). Requires read-only=false.AKAHU_MASK_ACCOUNTSWhen 'true', account numbers show only the bank code, last four digits and suffix. Default 'false' shows them in full. Transaction descriptions are never masked.
Tools this server provides (14)
Taken from the project documentation; the running server may differ.
- acct_list_accounts
- Lists every connected account with numbers and balances
- acct_get_account
- Gets one account by id
- acct_get_account_balance
- Gets the balance of one account
- acct_get_pending_transactions
- Lists unsettled transactions for one account
- txn_get_transactions
- Lists settled transactions filtered by account, dates, category or amount
- txn_get_transaction
- Gets one transaction by id
- txn_get_transactions_by_ids
- Gets several transactions in one request
- txn_get_pending_transactions
- Lists unsettled transactions across all accounts
- txn_search_transactions
- Case-insensitive search over description and merchant
- id_get_me
- Returns the Akahu user's profile
- acct_refresh_all_accounts
- Asks Akahu to fetch fresh data for every account
- acct_refresh_account
- Asks Akahu to fetch fresh data for one account
- txn_report_transaction_issue
- Opens a support ticket with Akahu about a transaction
- id_verify_name
- Checks a name against the account holder
What it does
- Read-only default
- Write tools refuse until you change AKAHU_READ_ONLY.
- Consent per write
- Each write shows exactly what will be sent before it runs.
- Transaction search
- Text search over descriptions and merchants, plus filters by date, category and amount.
- Account masking
- Optionally shows only the bank code, last four digits and suffix.
- Local operation
- Runs over stdio on your machine and calls only api.akahu.io.
- 14 tools
- Ten read tools and four write tools.
Good for
- Total last month's grocery spending by shop
- List subscriptions and their yearly cost
- Show balances across all connected accounts
- Find payments to a landlord this year
- Check pending transactions
Pricing
Open source
Free server; Akahu may charge for name verification
NZ Open Banking MCP (Akahu) FAQ
Is it safe to try?
It starts read-only, asks before each write, runs locally and does not log tokens or transaction contents.
What do I need?
An Akahu Personal App with its app token and user token, plus uv to run the server.
Is it affiliated with Akahu?
No, the README says it is unofficial.
Can it build budgets?
Not itself; there are no built-in reports, budgets or forecasts, so the assistant works them out from transactions.
Is NZ Open Banking MCP (Akahu) free?
Yes. NZ Open Banking MCP (Akahu) is open source, so you can use and self-host it for free.
How do I add NZ Open Banking MCP (Akahu) to Claude Code?
Run this command in your terminal: claude mcp add nz-openbank-mcp --env AKAHU_USER_TOKEN='<AKAHU_USER_TOKEN>' --env AKAHU_APP_TOKEN='<AKAHU_APP_TOKEN>' -- uvx nz-openbank-mcp
What are the best alternatives to NZ Open Banking MCP (Akahu)?
The closest alternatives to NZ Open Banking MCP (Akahu) are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.
Alternatives to NZ Open Banking MCP (Akahu)

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government