Skip to content
MCP server

Web Task

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.10.1
Listing updated
5 days ago

About Web Task

Web Task is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add web-task-api --env CLIPROXY_AUTH_TOKEN='<CLIPROXY_AUTH_TOKEN>' -- npx -y web-task-api

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • WEB_TASK_API_DATA_DIROptional 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_DIROptional recipes directory override. When omitted, web-task-api reads bundled recipes from the installed package.
  • WEB_TASK_API_TEMP_DIROptional temp root override used when incoming temp env variables point at your home directory or working directory.
  • WEB_TASK_API_MODELOptional shared default planner model for catalog-backed PI and OpenCode selections. Defaults to deepseek/deepseek-v4-flash.
  • WEB_TASK_API_VARIANTOptional shared default planner thinking variant for catalog-backed PI and OpenCode selections. Defaults to high.
  • WEB_TASK_API_PI_URLOptional PI engine base URL for the preferred planner backend. Defaults to http://127.0.0.1:8793.
  • WEB_TASK_API_PI_MODELOptional PI-specific planner model override. Defaults to WEB_TASK_API_MODEL when omitted.
  • WEB_TASK_API_PI_VARIANTOptional PI-specific thinking variant override. Defaults to WEB_TASK_API_VARIANT when omitted.
  • CLIPROXY_BASE_URLOptional CLIProxy base URL for the legacy fallback planner backend.
  • CLIPROXY_AUTH_TOKENOptional CLIProxy auth token for the legacy fallback planner backend.
  • CLIPROXY_MODELOptional CLIProxy model alias for the legacy fallback planner backend.
  • OPENCODE_BASE_URLOptional OpenCode base URL for the compatibility planner backend.
  • OPENCODE_MODELOptional OpenCode model name for the compatibility planner backend. Defaults to WEB_TASK_API_MODEL when omitted.
  • BROWSER_USER_DATA_DIROptional existing Chromium/Chrome user-data directory for warmed browser state reuse.
  • BROWSER_CHANNELOptional Playwright browser channel override, for example `chrome`.
  • HEADLESSOptional browser headless toggle. Set `false` to prefer a visible browser.

Pricing

Open source

Web Task FAQ

Is Web Task free?

Yes. Web Task is open source, so you can use and self-host it for free.

How do I add Web Task to Claude Code?

Run this command in your terminal: claude mcp add web-task-api --env CLIPROXY_AUTH_TOKEN='<CLIPROXY_AUTH_TOKEN>' -- npx -y web-task-api

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers