# NZ Open Banking MCP (Akahu)

> NZ Open Banking MCP (Akahu) is an open-source MCP server for finance and payments. Ask about your New Zealand bank accounts through Akahu, read-only unless you allow writes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Repository:** https://github.com/thatskiff33/nz-openbank-mcp
- **MCP Registry name:** io.github.thatskiff33/nz-openbank-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add nz-openbank-mcp --env AKAHU_USER_TOKEN='<AKAHU_USER_TOKEN>' --env AKAHU_APP_TOKEN='<AKAHU_APP_TOKEN>' -- uvx nz-openbank-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nz-openbank-mcp": {
      "command": "uvx",
      "args": [
        "nz-openbank-mcp"
      ],
      "env": {
        "AKAHU_USER_TOKEN": "<AKAHU_USER_TOKEN>",
        "AKAHU_APP_TOKEN": "<AKAHU_APP_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "nz-openbank-mcp": {
      "command": "uvx",
      "args": [
        "nz-openbank-mcp"
      ],
      "env": {
        "AKAHU_USER_TOKEN": "<AKAHU_USER_TOKEN>",
        "AKAHU_APP_TOKEN": "<AKAHU_APP_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "nz-openbank-mcp": {
      "command": "uvx",
      "args": [
        "nz-openbank-mcp"
      ],
      "env": {
        "AKAHU_USER_TOKEN": "<AKAHU_USER_TOKEN>",
        "AKAHU_APP_TOKEN": "<AKAHU_APP_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "nz-openbank-mcp": {
      "command": "uvx",
      "args": [
        "nz-openbank-mcp"
      ],
      "env": {
        "AKAHU_USER_TOKEN": "<AKAHU_USER_TOKEN>",
        "AKAHU_APP_TOKEN": "<AKAHU_APP_TOKEN>"
      }
    }
  }
}
```

## Tools

- `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

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/nz-open-banking-mcp-akahu
