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.2.4
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>"
      }
    }
  }
}

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.
  • CLIPROXY_BASE_URLOptional CLIProxy base URL for the cliproxy planner backend.
  • CLIPROXY_AUTH_TOKENOptional CLIProxy auth token for the cliproxy planner backend.
  • CLIPROXY_MODELOptional CLIProxy model alias for the cliproxy planner backend.
  • OPENCODE_BASE_URLOptional OpenCode base URL for the opencode planner backend.
  • OPENCODE_MODELOptional OpenCode model name for the opencode planner backend.
  • 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