Skip to main content
Glama
adriadam10

finanze-mcp

by adriadam10

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: Sharesight 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 .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

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    -
    quality
    D
    maintenance
    Enables AI-powered portfolio analysis for Wealthfolio, allowing Claude to query and analyze investment holdings, asset allocation, real estate properties, and execute transactions through natural language.
    Last updated
    1
  • 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.
    Last updated
    29
    4
    MIT
  • 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.
    Last updated
    17
    6
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    Integrates with Rotki portfolio tracker to provide portfolio overview, prices, transaction history, and analytics through intuitive tools for AI assistants.
    Last updated
    MIT

View all related MCP servers

Related MCP Connectors

  • Connect AI agents to bank accounts, transactions, balances, and investments.

  • Ask your AI about bank accounts, spending, debts, holdings, and investment activity.

  • Connect your Nubank account to AI via Brazil's Open Finance: balances, statements, cards, investment

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/adriadam10/finanze-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server