Nonlinear Calendar MCP Server

by singularitybpjadeio.github.singularitybpjade/balance-enginev0.2.1

Nonlinear Calendar: this year’s months fold onto the previous 12 years. No key to try.

Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active29d ago

Install Nonlinear Calendar MCP server

claude mcp add singularitybpjade -e BALANCE_API_KEY='<balance-api-key>' -- npx -y balance-engine-mcp

{
  "mcpServers": {
    "singularitybpjade": {
      "command": "npx",
      "args": [
        "-y",
        "balance-engine-mcp"
      ],
      "env": {
        "BALANCE_API_KEY": "<balance-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "singularitybpjade": {
      "command": "npx",
      "args": [
        "-y",
        "balance-engine-mcp"
      ],
      "env": {
        "BALANCE_API_KEY": "<balance-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "singularitybpjade": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "balance-engine-mcp"
      ],
      "env": {
        "BALANCE_API_KEY": "<balance-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "singularitybpjade": {
      "command": "npx",
      "args": [
        "-y",
        "balance-engine-mcp"
      ],
      "env": {
        "BALANCE_API_KEY": "<balance-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
BALANCE_API_KEY	—	yes	Account key from join.html (be_…) for your personal timetable. Leave empty for free tools (today/body/adjust/month/fold/sky/almanac/solar-terms). Empty key cannot call personal_day / personal_month.
BALANCE_ENGINE_API_BASE	—	—	Optional API origin. Default https://balance-engine.vercel.app

Remote endpoints

streamable-httphttps://balance-engine.vercel.app/api/mcp

Freshness

Active — last maintenance signal 29d ago. The newest of the signals below sets the band.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-11 · 29d ago · official registry · v0.2.1

FAQ

›How do I install the Nonlinear Calendar MCP server in Claude Code?

Run: claude mcp add singularitybpjade -e BALANCE_API_KEY='<balance-api-key>' -- npx -y balance-engine-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Nonlinear Calendar require an API key?

Yes. It expects BALANCE_API_KEY, of which 1 is a secret.

›Can I use Nonlinear Calendar as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Nonlinear Calendar in the official MCP registry?

Yes, as io.github.singularitybpjade/balance-engine.