Skip to main content
Glama
adriadam10

finanze-mcp

by adriadam10
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

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: FinanceKit MCP

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 .env
FINANZE_BASE_URL=http://localhost:7592
FINANZE_USERNAME=your-username
FINANZE_PASSWORD=your-password

Use with Claude Code

From the project folder:

claude mcp add --scope user --transport stdio finanze -- python -m finanze_mcp

Or 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 / env to your claude_desktop_config.json instead (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=true

Development

pip install -e ".[dev]"
pytest        # tests
ruff check .  # lint

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Sharesight MCP Server

    Haizzz
    A
    license
    B
    quality
    D
    maintenance
    Connects 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.
    29
    4
    MIT

  • FinanceKit MCP

    vdalhambra
    A
    license
    A
    quality
    C
    maintenance
    Provides AI agents with real-time financial market intelligence including stock quotes, crypto data, technical analysis, and portfolio insights. Enables natural language queries for current prices, technical indicators, asset comparisons, and portfolio analysis.
    17
    7
    MIT

  • Rotki MCP Server

    dennisonbertram
    A
    license
    B
    quality
    D
    maintenance
    Integrates with Rotki portfolio tracker to provide portfolio overview, prices, transaction history, and analytics through intuitive tools for AI assistants.
    7
    MIT

  • Fund Dashboard MCP Server

    DeliciousBuding
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents to manage and analyze personal investment portfolios, including fund and stock holdings, net value tracking, XIRR calculations, penetration analysis, and backtesting.
    Apache 2.0