nagoc-zerowork

A free Model Context Protocol (MCP) server that connects any MCP-compatible AI client (Claude Desktop, Cursor, Windsurf, Zed, etc.) to your ZeroWork TaskBots.

Because ZeroWork does not have a public REST API for managing bots, this MCP server acts as a Webhook Manager. You configure your TaskBot webhook URLs, and Claude can then dynamically trigger your automations, pass data to them, generate robust selectors, and query comprehensive ZeroWork documentation.

Features

• Trigger TaskBots — easily trigger any of your configured ZeroWork TaskBots
• Dynamic Data — pass JSON payloads to your TaskBots (populates zw_webhook_data)
• Search Official Docs — use search_zerowork_docs to query the entire ZeroWork documentation directly inside Claude
• Search Video Tutorials — use search_zerowork_tutorials to query 38+ official video masterclasses and WhatsApp automation guides
• Robust Selector Generator — use generate_robust_selector to create non-brittle CSS/XPath selectors tailored for ZeroWork
• Built-in Knowledge Base — Claude can read the embedded ZeroWork documentation resources to help you build and debug TaskBots
• Always up to date — uses @latest so every restart pulls the newest version automatically
• Zero install — runs via npx with no cloning required
• Multi-platform — works with Claude Desktop, Cursor, Windsurf, Zed, and any stdio MCP client

Requirements

• Node.js v18 or above (see below for how to install)
• ZeroWork Creator Account (to generate webhook URLs)

Step 1 — Install Node.js (one-time setup)

Node.js is a free program that allows this MCP to run on your computer. You only need to install it once.

1. Go to https://nodejs.org
2. Click the big "Download Node.js (LTS)" button
3. Open the downloaded file and click Next → Next → Finish (just like installing any normal app)
4. That's it — you're ready!

Not sure if you already have Node.js? Press Win + R, type cmd, press Enter, then type node -v and press Enter. If you see a version number (e.g. v20.x.x), you're all set.

Step 2 — Get your Webhook URLs

1. Open your ZeroWork Creator dashboard (creator.zerowork.io)
2. Go to your TaskBot -> Run Settings
3. Click "Generate Webhook"
4. Copy the webhook URL (e.g., https://hook.zerowork.io/...)

Step 3 — Setup (Claude Desktop)

Open your claude_desktop_config.json file and configure your bots using the ZEROWORK_BOTS environment variable. The value must be a valid JSON string mapping your custom bot names to their webhook URLs.

Note: The @latest tag ensures that every time Claude Desktop restarts, it automatically pulls the latest version of this MCP.

Windows:

{
  "mcpServers": {
    "nagoc-zerowork": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "nagoc-zerowork@latest"],
      "env": {
        "ZEROWORK_BOTS": "{\"scraperBot\":\"https://hook.zerowork.io/xxx\", \"dmBot\":\"https://hook.zerowork.io/yyy\"}"
      }
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "nagoc-zerowork": {
      "command": "npx",
      "args": ["-y", "nagoc-zerowork@latest"],
      "env": {
        "ZEROWORK_BOTS": "{\"scraperBot\":\"https://hook.zerowork.io/xxx\", \"dmBot\":\"https://hook.zerowork.io/yyy\"}"
      }
    }
  }
}

Save the file and restart Claude Desktop. The MCP server will connect automatically.

🎨 Workflow Diagram Generation

You can ask Claude to design a visual flowchart or an interactive blueprint of any automation workflow.

Just ask: "Build me a diagram for a [platform] [task] workflow" (e.g. "Build me a diagram for a WhatsApp cold outreach bot").

Claude will pause and ask you to choose between two styles:

1. Interactive HTML: Claude writes a premium, self-contained HTML file. Save it and open it in your browser to see a stunning Interactive Blueprint where you can click on any block to see the exact ZeroWork settings!
2. Mermaid Flowchart: Claude outputs the raw copyable Mermaid code block as text, so you can easily copy and paste it into Draw.io, Mermaid Live Editor, or any other software.

Because this MCP enforces strict ZeroWork naming rules, Claude will always use the exact building block names (e.g., Launch Browser, Start Repeat) in its diagrams.

How to Ask Claude

Once connected, you can ask Claude things like:

• "Build a diagram for a LinkedIn scraper bot"
• "Search ZeroWork video tutorials for how to scrape paginated data with nested loops."
• "Search ZeroWork docs for how to use multi-line JavaScript Code Blocks in dynamic inputs."
• "Here is an HTML snippet from LinkedIn. Generate a robust ZeroWork selector for the Connect button."
• "What ZeroWork bots do I have configured?"
• "Trigger my scraperBot"
• "Trigger my dmBot and send it this JSON payload: { 'email': '[email protected]' }"
• "How do I use variables in ZeroWork?"

Environment Variables

| Variable | Required | Description | |---|---|---| | ZEROWORK_BOTS | ❌ Optional | JSON string mapping bot names to webhook URLs. E.g. {"botName": "url"} |

Available Tools

• search_zerowork_docs - Searches the entire ZeroWork official documentation
• search_zerowork_tutorials - Searches 38+ official video masterclasses and automation guides
• generate_robust_selector - Analyzes HTML snippets to craft non-brittle ZeroWork selectors
• list_taskbots - Lists all configured TaskBots
• trigger_taskbot - Triggers a TaskBot without data
• trigger_taskbot_with_data - Triggers a TaskBot and passes JSON data
• trigger_webhook_url - Manually triggers any URL
• get_mcp_version - Gets the package version

Available Resources

• resource://zerowork/general
• resource://zerowork/webhooks
• resource://zerowork/variables
• resource://zerowork/tables
• resource://zerowork/selectors
• resource://zerowork/loops
• resource://zerowork/chatgpt
• resource://zerowork/anti_bot
• resource://zerowork/troubleshooting
• resource://zerowork/building_blocks
• resource://zerowork/dynamic_inputs
• resource://zerowork/visual_insights
• resource://zerowork/tutorials/tutorial_1 (up to tutorial_39 for full video transcripts)

License

ISC © nagoc