Skip to content
MCP server

NZ Open Banking MCP (Akahu)

Ask about your New Zealand bank accounts through Akahu, read-only unless you allow writes

Runs locallyStatus and history
Install
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-mcp

Add 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.Required
  • AKAHU_APP_TOKENApp token from https://my.akahu.nz/developers.Required
  • AKAHU_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)

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government