← Index

Ghostfolio MCP

io.github.mhajder/ghostfolio-mcp·v1.2.0·Other
Quality Score
95
/100

MCP server for Ghostfolio portfolio management and financial data access

§01  Install
Claude Desktop (uvx)
{
  "mcpServers": {
    "ghostfolio-mcp": {
      "command": "uvx",
      "args": [
        "ghostfolio-mcp"
      ],
      "env": {
        "GHOSTFOLIO_URL": "<ghostfolio_url>",
        "GHOSTFOLIO_TOKEN": "<your-ghostfolio_token>",
        "GHOSTFOLIO_VERIFY_SSL": "true",
        "GHOSTFOLIO_TIMEOUT": "30",
        "READ_ONLY_MODE": "false",
        "GHOSTFOLIO_DISABLED_TAGS": "<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",
        "MCP_HTTP_PORT": "8000",
        "MCP_TRANSPORT": "<mcp_transport>"
      }
    }
  }
}
Claude Desktop (Docker)
{
  "mcpServers": {
    "ghostfolio-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/mhajder/ghostfolio-mcp:1.2.0"
      ],
      "env": {
        "GHOSTFOLIO_URL": "<ghostfolio_url>",
        "GHOSTFOLIO_TOKEN": "<your-ghostfolio_token>",
        "GHOSTFOLIO_VERIFY_SSL": "true",
        "GHOSTFOLIO_TIMEOUT": "30",
        "READ_ONLY_MODE": "false",
        "GHOSTFOLIO_DISABLED_TAGS": "<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",
        "MCP_HTTP_PORT": "8000",
        "MCP_TRANSPORT": "<mcp_transport>"
      }
    }
  }
}
§02  Environment variables
GHOSTFOLIO_URL
required

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

GHOSTFOLIO_TOKEN
requiredsecret

Ghostfolio API token for authentication

GHOSTFOLIO_VERIFY_SSL

Verify SSL certificates (true/false)

GHOSTFOLIO_TIMEOUT

Request timeout in seconds

READ_ONLY_MODE

Enable read-only mode to restrict write operations

GHOSTFOLIO_DISABLED_TAGS

Comma-separated list of tags to disable tools for

LOG_LEVEL

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

RATE_LIMIT_ENABLED

Enable rate limiting

RATE_LIMIT_MAX_REQUESTS

Maximum requests per rate limit window

RATE_LIMIT_WINDOW_MINUTES

Rate limit window in minutes

TOOL_SEARCH_ENABLED

Enable FastMCP tool search transform

TOOL_SEARCH_STRATEGY

Tool search strategy (bm25 or regex)

TOOL_SEARCH_MAX_RESULTS

Maximum tool search results returned by search_tools

GHOSTFOLIO_URL
required

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

GHOSTFOLIO_TOKEN
requiredsecret

Ghostfolio API token for authentication

GHOSTFOLIO_VERIFY_SSL

Verify SSL certificates (true/false)

GHOSTFOLIO_TIMEOUT

Request timeout in seconds

READ_ONLY_MODE

Enable read-only mode to restrict write operations

GHOSTFOLIO_DISABLED_TAGS

Comma-separated list of tags to disable tools for

LOG_LEVEL

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

RATE_LIMIT_ENABLED

Enable rate limiting

RATE_LIMIT_MAX_REQUESTS

Maximum requests per rate limit window

RATE_LIMIT_WINDOW_MINUTES

Rate limit window in minutes

TOOL_SEARCH_ENABLED

Enable FastMCP tool search transform

TOOL_SEARCH_STRATEGY

Tool search strategy (bm25 or regex)

TOOL_SEARCH_MAX_RESULTS

Maximum tool search results returned by search_tools

MCP_HTTP_PORT

Port for HTTP server (default: 8000)

MCP_TRANSPORT

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

GHOSTFOLIO_URL
required

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

GHOSTFOLIO_TOKEN
requiredsecret

Ghostfolio API token for authentication

GHOSTFOLIO_VERIFY_SSL

Verify SSL certificates (true/false)

GHOSTFOLIO_TIMEOUT

Request timeout in seconds

READ_ONLY_MODE

Enable read-only mode to restrict write operations

GHOSTFOLIO_DISABLED_TAGS

Comma-separated list of tags to disable tools for

LOG_LEVEL

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

RATE_LIMIT_ENABLED

Enable rate limiting

RATE_LIMIT_MAX_REQUESTS

Maximum requests per rate limit window

RATE_LIMIT_WINDOW_MINUTES

Rate limit window in minutes

TOOL_SEARCH_ENABLED

Enable FastMCP tool search transform

TOOL_SEARCH_STRATEGY

Tool search strategy (bm25 or regex)

TOOL_SEARCH_MAX_RESULTS

Maximum tool search results returned by search_tools

MCP_HTTP_PORT

Port for HTTP server (default: 8000)

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
20
installability
25
documentation
15
stability
10
§04  Alternatives in Other