Official Windmill MCP to run scripts and flows and manage jobs, resources and schedules.

How it works

Foe: Clockwork Imp, a chore you keep doing by hand.

Foes

  • Clockwork Imp

Party · Context

  • ArtificerYour agent100/100
  1. Clockwork Imp

    The Clockwork Imp blocks the way.

    What really happensIt stands for a chore you keep doing by hand.

    Artificer: Context 100/100.

  2. Grind

    The imp winds up and hits again, and again.

    What really happensA chore done by hand repeats until someone automates it.

    Artificer takes 3. Artificer takes 3. Artificer takes 3. Artificer: Context 91/100.

  3. Windmill MCP

    The Windmill Orb opens a portal into one workspace.

    What really happensClaude Code connects over HTTP to your Windmill MCP URL. OAuth uses <base_url>/api/mcp/gateway. A token URL also works.

    Clockwork Imp takes 29.

  4. Windmill MCP

    The orb lists scripts, flows, jobs and resources in scope.

    What really happensWorkspace scripts and flows become tools. Built-in tools cover jobs, resources, variables, schedules and workers. Folder scope can hide the rest.

    Clockwork Imp takes 13.

  5. Grind

    The Clockwork Imp uses Grind.

    Artificer takes 3. Artificer takes 3. Artificer takes 3. Artificer: Context 82/100.

  6. Windmill MCP

    A strike runs a script or flow, then reads the job that follows.

    What really happensrunScriptByPath and runFlowByPath execute workspace code. getJob and getJobLogs report status. The server can also create scripts, flows, resources and schedules.

    Clockwork Imp takes 32.

  7. Windmill MCP

    The imp drops the job result inside the chat.

    What really happensResults come back in the client. A token in the URL can leak through history and logs. Prefer the OAuth gateway, or send the token as a Bearer header.

    Clockwork Imp takes 26. Clockwork Imp falls.

  8. Victory

    The Clockwork Imp falls.

Learn this spell

Claude Code

claude mcp add --transport http windmill <windmill_url_with_token>

Notes

Needs a Windmill Cloud or self-hosted workspace. OAuth gateway is <base_url>/api/mcp/gateway. The Claude Code command in the docs uses a token URL. Token URLs can land in history and logs. A superadmin can refuse ?token= and force OAuth or a Bearer header. Folder scope limits which scripts and flows appear. No Codex setup is documented.

This spell has no recorded sessions in the curator's logs. Tried it? Send a spell report.