finanze-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
finanze-mcp
An MCP server for Finanze, the self-hosted portfolio manager.
It lets an AI assistant (Claude Code, Claude Desktop…) read your Finanze portfolio and run financial calculations in plain language — "what's my net worth?", "show my crypto positions", "simulate this mortgage".
It talks to your local Finanze backend over its HTTP API and exposes a read-only tool set (plus optional live-refresh). It never changes your data.
What it can do
See your portfolio: positions, contributions, transactions, net-worth timeline, history.
Markets: exchange & Euribor rates, stock/fund/ETF lookup, crypto asset search.
Real estate & cash flows: properties, recurring and pending flows.
Calculations: loan/mortgage amortization, savings projections, portfolio forecast.
Optional live refresh (off by default): trigger a data fetch from your connected banks, brokers and crypto wallets.
Related MCP server: Rotki MCP Server
Requirements
A running Finanze backend (default
http://localhost:7592).Python 3.11+.
Install
git clone https://github.com/adriadam10/finanze-mcp.git
cd finanze-mcp
pip install -e .Configure
Copy the example env file and fill in your Finanze credentials (used to unlock the local DB):
cp .env.example .envFINANZE_BASE_URL=http://localhost:7592
FINANZE_USERNAME=your-username
FINANZE_PASSWORD=your-passwordUse with Claude Code
From the project folder:
claude mcp add --scope user --transport stdio finanze -- python -m finanze_mcpOr rely on the bundled .mcp.json (project scope): open Claude Code in this directory with
FINANZE_USERNAME / FINANZE_PASSWORD exported, and it's picked up automatically.
Then just ask Claude things like "what's my current net worth?".
Claude Desktop: add the same
command/args/envto yourclaude_desktop_config.jsoninstead (Claude Desktop doesn't use.mcp.json).
Optional: live data refresh
Disabled by default. To expose the fetch tools (they make real calls to your banks/brokers and may require 2FA), set:
FINANZE_ENABLE_FETCH=trueDevelopment
pip install -e ".[dev]"
pytest # tests
ruff check . # lintLicense
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Ask your AI about your own accounts, debts, budgets and goals. OAuth sign-in, read-only by default.
Track your net worth, holdings, history and bank spending, and update them from your AI.
1Personal finance, bank account, and shared memory connector for Claude, ChatGPT, Gemini Spark & more
Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.
Related MCP Servers
- AlicenseBqualityDmaintenanceConnects AI assistants to the Sharesight portfolio tracking platform via the v3 API for managing investment portfolios and holdings. It enables natural language queries for performance reporting, dividend tracking, and custom investment management.295MIT
- AlicenseBqualityDmaintenanceIntegrates with Rotki portfolio tracker to provide portfolio overview, prices, transaction history, and analytics through intuitive tools for AI assistants.7MIT
- FlicenseNot gradedqualityDmaintenanceConnects AI assistants to Kuvera mutual fund portfolios, enabling real-time queries about holdings, performance, and fund details.-
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to read and write a self-hosted portfolio tracker through 25 MCP tools, covering net worth, flows, forecasts, decisions, and audit.8 npm4Apache 2.0