io.github.mhajder/ghostfolio-mcp

Official

by mhajder · Python

Ghostfolio MCP

MCP server for Ghostfolio portfolio management and financial data access

Portfolio management and financial data access for Ghostfolio.

Topics

ghostfoliomcpmcp-servermcp-tools

Install

Configuration

Environment variables

GHOSTFOLIO_URLrequired

Ghostfolio base URL (e.g., https://domain.tld:3333)

GHOSTFOLIO_TOKENrequiredsecret

Ghostfolio API token for authentication

GHOSTFOLIO_VERIFY_SSLdefault true

Verify SSL certificates (true/false)

GHOSTFOLIO_TIMEOUTdefault 30

Request timeout in seconds

READ_ONLY_MODEdefault false

Enable read-only mode to restrict write operations

GHOSTFOLIO_DISABLED_TAGS

Comma-separated list of tags to disable tools for

LOG_LEVELdefault INFO

Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)

RATE_LIMIT_ENABLEDdefault false

Enable rate limiting

RATE_LIMIT_MAX_REQUESTSdefault 60

Maximum requests per rate limit window

RATE_LIMIT_WINDOW_MINUTESdefault 1

Rate limit window in minutes

TOOL_SEARCH_ENABLEDdefault false

Enable FastMCP tool search transform

TOOL_SEARCH_STRATEGYdefault bm25

Tool search strategy (bm25 or regex)

TOOL_SEARCH_MAX_RESULTSdefault 5

Maximum tool search results returned by search_tools

MCP_HTTP_PORTdefault 8000

Port for HTTP server (default: 8000)

MCP_TRANSPORTdefault http

MCP transport type (http for HTTP, stdio for stdio)

Arguments

-prequireddefault {MCP_HTTP_PORT}:8000

claude_desktop_config.json

{
  "mcpServers": {
    "ghostfolio-mcp": {
      "command": "uvx",
      "args": [
        "ghostfolio-mcp"
      ],
      "env": {
        "GHOSTFOLIO_URL": "<YOUR_GHOSTFOLIO_URL>",
        "GHOSTFOLIO_TOKEN": "<YOUR_GHOSTFOLIO_TOKEN>",
        "GHOSTFOLIO_VERIFY_SSL": "true",
        "GHOSTFOLIO_TIMEOUT": "30",
        "READ_ONLY_MODE": "false",
        "GHOSTFOLIO_DISABLED_TAGS": "<YOUR_GHOSTFOLIO_DISABLED_TAGS>",
        "LOG_LEVEL": "INFO",
        "RATE_LIMIT_ENABLED": "false",
        "RATE_LIMIT_MAX_REQUESTS": "60",
        "RATE_LIMIT_WINDOW_MINUTES": "1",
        "TOOL_SEARCH_ENABLED": "false",
        "TOOL_SEARCH_STRATEGY": "bm25",
        "TOOL_SEARCH_MAX_RESULTS": "5"
      }
    }
  }
}