Ghostfolio MCP

Ghostfolio MCP Server is a Python-based Model Context Protocol (MCP) server designed to provide advanced, programmable access to Ghostfolio portfolio management and financial data. It exposes a modern API for querying, analyzing, and managing your investment portfolio through Ghostfolio's comprehensive features. The server supports both read and write operations, robust security features, and is suitable for…. Its 36 documented tools cover account, portfolio, data, asset.

People connecting finance tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-24 · ★ 17 · #43 OF 283 MAINTAINED FINANCE · VERIFIED 2026-08-25

AGPL-3.0 · Python servers · how we verify → /methodology

01 · Install Ghostfolio MCP

before you install - you'll need

Set GHOSTFOLIO_URL, GHOSTFOLIO_TOKEN, GHOSTFOLIO_VERIFY_SSL, GHOSTFOLIO_TIMEOUT, READ_ONLY_MODE, LOG_LEVEL, RATE_LIMIT_ENABLED, RATE_LIMIT_MAX_REQUESTS, RATE_LIMIT_WINDOW_MINUTES, TOOL_SEARCH_ENABLED, TOOL_SEARCH_STRATEGY before connecting. TOOL_SEARCH_MAX_RESULTS is optional or environment-specific per the README.

Claude Code

claude mcp add mhajder-ghostfolio-mcp -- uvx ghostfolio-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "mhajder-ghostfolio-mcp": {
      "command": "uvx",
      "args": [
        "ghostfolio-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · container (OCI image) - can be sandboxed away from your filesystem

license AGPL-3.0 - declared in the repository

pypi package ghostfolio-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.mhajder is GitHub-verified and matches the repo owner

03 · What Ghostfolio MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can get all accounts in your portfolio including account types and balances, get account balances for a specific account, create a new account in your portfolio, and delete an existing account from your portfolio (destructive operation).

Capability map

Tools grouped from the project's README - what Ghostfolio MCP lets an agent do.

read & search

13 tools - e.g. Get all accounts in your portfolio including account types and balances; Get position details for a specific symbol from a data source; Get investment data grouped by time period showing cash flows and…

get_accounts · get_position · get_investments · get_orders · get_benchmarks · get_benchmark_performance…

Account

6 tools - e.g. Get account balances for a specific account; Create a new account in your portfolio; Delete an existing account from your portfolio (destructive operation)

get_account_balances · create_account · delete_account · get_account_details · update_account · transfer_account_balance

Portfolio

4 tools - e.g. Get portfolio performance data including returns, benchmarks, and performance metrics; Get portfolio holdings and positions including allocations and asset breakdowns; Get comprehensive portfolio details…

get_portfolio_performance · get_portfolio_holdings · get_portfolio_details · export_portfolio

Watchlist

3 tools - e.g. Get all items in the user's watchlist; Add a symbol to the user's watchlist; Remove a symbol from the user's watchlist

get_watchlist · add_to_watchlist · remove_from_watchlist

Asset

3 tools - e.g. Get asset profile information for a specific symbol; Create-or-update an asset profile (idempotent; tolerates Ghostfolio's HTTP 500 on the create step and relies on the subsequent PATCH as the source of…

get_asset_profile · upsert_asset_profile · delete_asset_profile

Dividends

2 tools - e.g. Get dividend data grouped by time period showing dividend payments and yield; Fetch historical dividend data formatted for import for a specific symbol

get_dividends · get_dividends_for_import

Activity

2 tools - e.g. Create a single new transaction/activity in your portfolio (BUY, SELL, DIVIDEND, INTEREST, FEE, etc.); Delete a single activity/transaction by its ID (destructive operation)

create_activity · delete_activity

Market

2 tools - e.g. Get market data for a specific asset; Add one or more market data points for an asset (typically a MANUAL data source - Ghostfolio rejects writes for auto-fetched sources)

get_market_data_for_asset · add_market_data_points

Latest releases

v1.6.0 · 2026-08-19

Docker Images · ghcr.io/mhajder/ghostfolio-mcp:v1.6.0 · ghcr.io/mhajder/ghostfolio-mcpo:v1.6.0 · add optional OIDC/OAuth authentication for HTTP transports · New Contributors · @pierdom made their first contribution in

v1.5.0 · 2026-07-14

Docker Images · ghcr.io/mhajder/ghostfolio-mcp:v1.5.0 · ghcr.io/mhajder/ghostfolio-mcpo:v1.5.0 · bump the uv-dependencies group across 1 directory with 2 updates · bump the uv-dev-dependencies group across 1 directory…

v1.4.3 · 2026-07-06

Docker Images · ghcr.io/mhajder/ghostfolio-mcp:v1.4.3 · ghcr.io/mhajder/ghostfolio-mcpo:v1.4.3

04 · Who maintains Ghostfolio MCP

Ghostfolio MCP is maintained by mhajder. We track 3 MCP servers from mhajder - 3 actively maintained, 63 combined GitHub stars, oldest repo from Aug 2025. Full record: all servers from mhajder.

05 · Facts

repository: github.com/mhajder/ghostfolio-mcp
website: https://github.com/mhajder/ghostfolio-mcp
category: finance - ranked #43 of 283 actively-maintained finance servers as of 2026-08-25.
release cadence: 5 releases in the last 90 days (latest 2026-08-19)
registry: io.github.mhajder/ghostfolio-mcp (active, first published 2026-04-09 · 9 versions)
packages: pypi:ghostfolio-mcp · pypi:ghostfolio-mcp · oci:ghcr.io/mhajder/ghostfolio-mcp:1.6.0

06 · Ghostfolio MCP FAQ

Is Ghostfolio MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-24 and it shipped 5 releases in the last 90 days. We re-verify nightly.

What can Ghostfolio MCP do?

How do I install Ghostfolio MCP?

Run `uvx ghostfolio-mcp`. The README documents 12 environment variables (GHOSTFOLIO_URL, GHOSTFOLIO_TOKEN, GHOSTFOLIO_VERIFY_SSL…) to set first. Set GHOSTFOLIO_URL, GHOSTFOLIO_TOKEN, GHOSTFOLIO_VERIFY_SSL, GHOSTFOLIO_TIMEOUT, READ_ONLY_MODE, LOG_LEVEL, RATE_LIMIT_ENABLED, RATE_LIMIT_MAX_REQUESTS, RATE_LIMIT_WINDOW_MINUTES, TOOL_SEARCH_ENABLED, TOOL_SEARCH_STRATEGY before connecting. TOOL_SEARCH_MAX_RESULTS is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Ghostfolio MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Ghostfolio MCP

Alternatives to Ghostfolio MCP

Maintained finance servers if Ghostfolio MCP isn't the fit.

Pairs well with

Servers that cover what Ghostfolio MCP doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Quanttogo MCP (michaeljiangmingfeng-debug) · Bantou · Agenticorg · T2000 · jPOS MCP Server

More Python MCP servers · LibreNMS MCP · Zabbix MCP · Relay · PLwC - Personality Layer with Conscience · Hot Memory MCP · see all