akahu-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@akahu-mcp list my bank accounts"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.accountmatches by id or fuzzy name substring.
Related MCP server: financy
Setup
Install
uvif you don't have it.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 auser_tokenfor yourself.Create a
.envfile in the project root:AKAHU_USER_TOKEN=user_token_xxx AKAHU_APP_TOKEN=app_token_xxxuv syncto install dependencies.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-mcpClaude 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 withuv sync --group legacy, thenuv run --group legacy python legacy/list_accounts.py.
Available Tools
3 toolslist_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
Scored across 3 tools
Each tool targets a distinct area: share holdings, bank accounts, and transactions. There is no overlap in purpose.
All tool names follow a consistent verb_noun pattern: get_share_holdings, list_accounts, list_transactions.
3 tools cover the core read-only functionalities for personal finance. While limited, it is appropriate for the server's scope.
The set covers accounts, transactions, and investments, but lacks operations like getting a single account detail or investment transactions, leaving some gaps.
Maintenance
Related MCP Connectors
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Read-only finance MCP server. Connects your banks, cards, payment apps, books and payroll into one ledger for your AI. Can't move money. Open source (AGPL-3.0), free during beta.
Personal finance for AI agents — onboard, import statements, categorize & budget over MCP.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn 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
- AlicenseNot gradedqualityBmaintenanceMCP server that exposes banking data (connections, accounts, balances, transactions) and agent skills, allowing AI agents to query and refresh financial data via stdio.154 npm6Apache 2.0
- AlicenseNot gradedqualityCmaintenanceA 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
- AlicenseAqualityDmaintenanceAn MCP server exposing the Akahu banking API as tools to list accounts, get balances, and fetch transactions.3AGPL 3.0