Connect in 60 seconds

Claude Desktop — custom connector (easiest)

Settings → Connectors → Add custom connector → paste the URL:

https://your-space.hf.space/mcp

Claude Code (CLI)

One command adds it as an HTTP server:

claude mcp add --transport http personal-finance https://your-space.hf.space/mcp

Cursor / VS Code / any IDE

Add to your mcp.json (or the IDE’s MCP settings):

{
  "mcpServers": {
    "personal-finance": {
      "url": "https://your-space.hf.space/mcp",
      "transport": "http"
    }
  }
}

Claude Desktop via config file (stdio bridge)

If you prefer the config file, bridge the remote server with mcp-remote. Edit claude_desktop_config.json:

{
  "mcpServers": {
    "personal-finance": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-space.hf.space/mcp"]
    }
  }
}

Run it locally (stdio, fully offline)

Clone the repo and point Claude Desktop at the local process:

pip install -e .
# claude_desktop_config.json
{
  "mcpServers": {
    "personal-finance": {
      "command": "python",
      "args": ["-m", "src"]
    }
  }
}

Other IDEs & MCP clients

Cursor / Windsurf / Zed — add an HTTP MCP server in mcp.json (or the app’s MCP settings):

{
  "mcpServers": {
    "personal-finance": { "url": "https://your-space.hf.space/mcp", "transport": "http" }
  }
}

Continue (~/.continue/config.yaml):

mcpServers:
  - name: personal-finance
    transport: streamable-http
    url: https://your-space.hf.space/mcp

Cline (VS Code) — MCP Servers panel → Add remote server → paste https://your-space.hf.space/mcp. If a client only supports stdio, bridge it with npx mcp-remote https://your-space.hf.space/mcp.