Web Task MCP Server

by jojo-labsio.github.jojo-labs/web-task-apiv0.10.1

Browser tasks, sessions, and recipes for MCP and HTTP automation.

Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing4mo ago

Install Web Task MCP server

claude mcp add web-task-api -e CLIPROXY_AUTH_TOKEN='<cliproxy-auth-token>' -- npx -y web-task-api

{
  "mcpServers": {
    "web-task-api": {
      "command": "npx",
      "args": [
        "-y",
        "web-task-api"
      ],
      "env": {
        "CLIPROXY_AUTH_TOKEN": "<cliproxy-auth-token>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "web-task-api": {
      "command": "npx",
      "args": [
        "-y",
        "web-task-api"
      ],
      "env": {
        "CLIPROXY_AUTH_TOKEN": "<cliproxy-auth-token>"
      }
    }
  }
}

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

{
  "servers": {
    "web-task-api": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "web-task-api"
      ],
      "env": {
        "CLIPROXY_AUTH_TOKEN": "<cliproxy-auth-token>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "web-task-api": {
      "command": "npx",
      "args": [
        "-y",
        "web-task-api"
      ],
      "env": {
        "CLIPROXY_AUTH_TOKEN": "<cliproxy-auth-token>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
WEB_TASK_API_DATA_DIR	—	—	Optional mutable data root for web-task-api runs, sessions, profiles, and temp state. When omitted, the runtime uses a platform user-data directory instead of the ambient cwd.
WEB_TASK_API_RECIPES_DIR	—	—	Optional recipes directory override. When omitted, web-task-api reads bundled recipes from the installed package.
WEB_TASK_API_TEMP_DIR	—	—	Optional temp root override used when incoming temp env variables point at your home directory or working directory.
WEB_TASK_API_MODEL	—	—	Optional shared default planner model for catalog-backed PI and OpenCode selections. Defaults to deepseek/deepseek-v4-flash.
WEB_TASK_API_VARIANT	—	—	Optional shared default planner thinking variant for catalog-backed PI and OpenCode selections. Defaults to high.
WEB_TASK_API_PI_URL	—	—	Optional PI engine base URL for the preferred planner backend. Defaults to http://127.0.0.1:8793.
WEB_TASK_API_PI_MODEL	—	—	Optional PI-specific planner model override. Defaults to WEB_TASK_API_MODEL when omitted.
WEB_TASK_API_PI_VARIANT	—	—	Optional PI-specific thinking variant override. Defaults to WEB_TASK_API_VARIANT when omitted.
CLIPROXY_BASE_URL	—	—	Optional CLIProxy base URL for the legacy fallback planner backend.
CLIPROXY_AUTH_TOKEN	—	yes	Optional CLIProxy auth token for the legacy fallback planner backend.
CLIPROXY_MODEL	—	—	Optional CLIProxy model alias for the legacy fallback planner backend.
OPENCODE_BASE_URL	—	—	Optional OpenCode base URL for the compatibility planner backend.
OPENCODE_MODEL	—	—	Optional OpenCode model name for the compatibility planner backend. Defaults to WEB_TASK_API_MODEL when omitted.
BROWSER_USER_DATA_DIR	—	—	Optional existing Chromium/Chrome user-data directory for warmed browser state reuse.
BROWSER_CHANNEL	—	—	Optional Playwright browser channel override, for example `chrome`.
HEADLESS	—	—	Optional browser headless toggle. Set `false` to prefer a visible browser.

Freshness

Slowing — last maintenance signal 4mo 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-05-28 · 4mo ago · official registry · v0.10.1

FAQ

›How do I install the Web Task MCP server in Claude Code?

Run: claude mcp add web-task-api -e CLIPROXY_AUTH_TOKEN='<cliproxy-auth-token>' -- npx -y web-task-api. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Web Task require an API key?

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

›Can I use Web Task as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Web Task in the official MCP registry?

Yes, as io.github.jojo-labs/web-task-api.