Ghostfolio MCP Server
by mhajderio.github.mhajder/ghostfolio-mcpv1.7.0
MCP server for Ghostfolio portfolio management and financial data access
context tax
queued
security
queued
cold start
queued
freshness
Active22d ago
Install Ghostfolio MCP server
Install in Claude Code
claude mcp add ghostfolio -e GHOSTFOLIO_URL='<ghostfolio-url>' -e GHOSTFOLIO_TOKEN='<ghostfolio-token>' -- uvx ghostfolio-mcpInstall in Cursor
{
"mcpServers": {
"ghostfolio": {
"command": "uvx",
"args": [
"ghostfolio-mcp"
],
"env": {
"GHOSTFOLIO_URL": "<ghostfolio-url>",
"GHOSTFOLIO_TOKEN": "<ghostfolio-token>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"ghostfolio": {
"command": "uvx",
"args": [
"ghostfolio-mcp"
],
"env": {
"GHOSTFOLIO_URL": "<ghostfolio-url>",
"GHOSTFOLIO_TOKEN": "<ghostfolio-token>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"ghostfolio": {
"type": "stdio",
"command": "uvx",
"args": [
"ghostfolio-mcp"
],
"env": {
"GHOSTFOLIO_URL": "<ghostfolio-url>",
"GHOSTFOLIO_TOKEN": "<ghostfolio-token>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"ghostfolio": {
"command": "uvx",
"args": [
"ghostfolio-mcp"
],
"env": {
"GHOSTFOLIO_URL": "<ghostfolio-url>",
"GHOSTFOLIO_TOKEN": "<ghostfolio-token>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| GHOSTFOLIO_URL | yes | — | Ghostfolio base URL (e.g., https://domain.tld:3333) |
| GHOSTFOLIO_TOKEN | yes | yes | 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) |
Freshness
Active — last maintenance signal 22d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-17 · 22d ago · GitHub
Latest release
2026-09-17 · 22d ago · GitHub · v1.7.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-17 · 22d ago · official registry · v1.7.0
FAQ
›How do I install the Ghostfolio MCP server in Claude Code?
Run: claude mcp add ghostfolio -e GHOSTFOLIO_URL='<ghostfolio-url>' -e GHOSTFOLIO_TOKEN='<ghostfolio-token>' -- uvx ghostfolio-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Ghostfolio require an API key?
Yes. It expects GHOSTFOLIO_URL, GHOSTFOLIO_TOKEN, of which 1 is a secret.
›Can I use Ghostfolio as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is Ghostfolio in the official MCP registry?
Yes, as io.github.mhajder/ghostfolio-mcp.