SSyncDev

Ghostfolio MCP Server

MCP server for Ghostfolio portfolio management and financial data access

Local serverstdioPython

What is the Ghostfolio MCP Server?

MCP server for Ghostfolio portfolio management and financial data access

The short version

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 integration with automation tools, financial dashboards, and custom portfolio management applications.

What it needs from you

  • Python 3.11 or higher - Access to a Ghostfolio instance - Valid Ghostfolio API token

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_accountsGet all accounts in your portfolio including account types and balances
get_account_balancesGet account balances for a specific account
create_accountCreate a new account in your portfolio
delete_accountDelete an existing account from your portfolio (destructive operation)
get_account_detailsGet details for a specific account
update_accountUpdate settings or details of an existing account
transfer_account_balanceTransfer cash balances between two accounts
get_portfolio_performanceGet portfolio performance data including returns, benchmarks, and performance metrics
get_portfolio_holdingsGet portfolio holdings and positions including allocations and asset breakdowns
get_portfolio_detailsGet comprehensive portfolio details including accounts, positions, and summary
get_positionGet position details for a specific symbol from a data source
get_investmentsGet investment data grouped by time period showing cash flows and contributions
get_dividendsGet dividend data grouped by time period showing dividend payments and yield
get_ordersGet all activities/orders from your portfolio, optionally filtered by account

How to install the Ghostfolio MCP Server

{
  "mcpServers": {
    "ghostfolio": {
      "command": "uvx",
      "args": ["ghostfolio-mcp"],
      "env": {
        "GHOSTFOLIO_URL": "your-value",
        "GHOSTFOLIO_TOKEN": "your-value",
        "SENTRY_DSN": "your-value",
        "MCP_HTTP_HOST": "your-value",
        "MCP_HTTP_BEARER_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Python 3.11 or higher - Access to a Ghostfolio instance - Valid Ghostfolio API token
VariableDescriptionRequired
GHOSTFOLIO_URLEndpoint or connection string the server talks to.Yes
GHOSTFOLIO_TOKENCredential the server authenticates with.Yes
SENTRY_DSNEndpoint or connection string the server talks to.Yes
MCP_HTTP_HOSTEndpoint or connection string the server talks to.Optional
MCP_HTTP_BEARER_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use Ghostfolio MCP to get accounts.”
  • “Use Ghostfolio MCP to get account balances.”
  • “Use Ghostfolio MCP to create account.”

Frequently asked questions

MCP server for Ghostfolio portfolio management and financial data access Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.