openfolio-ro-mcp

Read-only MCP for OpenFolio. It talks to https://codytang.cn/api/external/ro — you do not clone the app.

Need Node 20+ and an API key. Put the key in OPENFOLIO_RO_KEY.

Tools: ro_catalog (what exists), ro_holdings (broker positions), ro_grid (%-grids), ro_logs (server logs). No orders.

Cursor / Claude / CodeBuddy

{
  "mcpServers": {
    "openfolio-ro": {
      "command": "npx",
      "args": ["-y", "github:cody1991/openfolio-ro-mcp"],
      "env": {
        "OPENFOLIO_RO_KEY": "<key>",
        "OPENFOLIO_ORIGIN": "https://codytang.cn"
      }
    }
  }
}

If Cursor fails with ENOENT under Cursor.app/.../resources/lib, keep command as npx and add "NPM_CONFIG_PREFIX": " " to env (a single space; Cursor bug).

Related MCP server: EODHD MCP Server

Codex

[mcp_servers.openfolio_ro]
command = "npx"
args = ["-y", "github:cody1991/openfolio-ro-mcp"]
env = { OPENFOLIO_RO_KEY = "<key>", OPENFOLIO_ORIGIN = "https://codytang.cn" }

OPENFOLIO_ORIGIN 默认就是 https://codytang.cn，可省略；只有打别的主机时才改。

Logs

ro_logs requires module or search. Default 50 rows, max 100.