Skip to main content
Glama
akahu-mcp

akahu-mcp

by NZKea

akahu-mcp

An MCP server that exposes Akahu (New Zealand open-banking) data to LLM agents like Claude. Lets the agent list your bank accounts, inspect your investment holdings, and pull transactions for analysis.

A local SQLite cache (cache.db) keeps the last ~90 days of transactions on disk and refreshes incrementally. The cache TTL is 24h to match Akahu Personal's once-a-day upstream refresh; agents can pass force=True on any tool to bypass it.

Tools

  • list_accounts(force=False) — bank/depository accounts with balances. Sharesight is excluded.

  • get_share_holdings(force=False) — Sharesight portfolio: total value, breakdown (returns / capital / currency / dividends), and per-holding rows.

  • list_transactions(account, start=None, end=None, limit=100, force=False) — transactions for one account from the local cache, refreshing from Akahu first if the cache is older than 24h. account matches by id or fuzzy name substring.

Related MCP server: financy

Setup

  1. Install uv if you don't have it.

  2. Set up an Akahu Personal App — these are free, single-user apps you create against your own Akahu account. You'll get an app_token (the personal app's id) and a user_token for yourself.

  3. Create a .env file in the project root:

    AKAHU_USER_TOKEN=user_token_xxx
    AKAHU_APP_TOKEN=app_token_xxx
  4. uv sync to install dependencies.

  5. Smoke-test: uv run python -m akahu_mcp.sync — should print your accounts and fetch transactions for the first one.

Wiring it into an MCP host

Claude Code

claude mcp add akahu --scope user -- uv --directory /absolute/path/to/akahu-mcp run akahu-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on your platform:

{
  "mcpServers": {
    "akahu": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/akahu-mcp", "run", "akahu-mcp"]
    }
  }
}

If your host can't find uv on PATH, replace "uv" with the absolute path from which uv.

Notes

  • Built and tested against Akahu Personal Apps, which only refresh upstream data once per day — hence the 24h cache TTL. The same endpoints exist on commercial plans, but TTLs may be worth shortening there.

  • legacy/ contains the two original scripts (akahu.py, list_accounts.py) that this project grew out of. They still work standalone — install their deps with uv sync --group legacy, then uv run --group legacy python legacy/list_accounts.py.

Available Tools

3 tools
get_share_holdingsB

Return the user's Sharesight investment portfolio: total value, breakdown (returns / capital / currency / dividends) and the per-holding list (symbol, shares, value, returns).

Inputs: force. Returns: object

list_accountsA

List the user's bank/depository accounts (excludes Sharesight, which has its own tool). Cached for 24h; pass force=True to refresh from Akahu.

Inputs: force. Returns: result

list_transactionsA

List transactions for a bank account, served from a local cache that keeps the last ~90 days. The cache is refreshed at most once per 24h (Akahu Personal only refreshes upstream daily); pass force=True to bypass the TTL.

Args: account: account id or fuzzy substring match against account name start: ISO date (YYYY-MM-DD), inclusive lower bound on transaction date end: ISO date (YYYY-MM-DD), inclusive upper bound limit: max rows to return (default 100, newest first) force: bypass the 24h cache TTL

Inputs: account (required), start, end, limit, +1 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a distinct area: share holdings, bank accounts, and transactions. There is no overlap in purpose.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern: get_share_holdings, list_accounts, list_transactions.

    Tool Count4/5

    3 tools cover the core read-only functionalities for personal finance. While limited, it is appropriate for the server's scope.

    Completeness3/5

    The set covers accounts, transactions, and investments, but lacks operations like getting a single account detail or investment transactions, leaving some gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that integrates with local Ollama LLMs to provide financial analysis through four specialized agents (Market Analyst, Portfolio Manager, Risk Analyst, and Explainability Agent) with comprehensive banking tools.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server that exposes banking data (connections, accounts, balances, transactions) and agent skills, allowing AI agents to query and refresh financial data via stdio.
      154 npm
      6
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      A local MCP server that syncs New Zealand bank accounts from Akahu into a local SQLite cache, offering tools for transaction search, spending summaries, cashflow, recurring charges, and more for natural language money queries.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server exposing the Akahu banking API as tools to list accounts, get balances, and fetch transactions.
      3
      AGPL 3.0