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 ImpHaze Poison Ward Insight Flicker Pinned Enraged
Party · Context
- ArtificerYour agent100/100Haze Poison Ward Insight Flicker Pinned Enraged
The Clockwork Imp blocks the way.
What really happensIt stands for a chore you keep doing by hand.
Artificer: Context 100/100.
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.
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.
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.
The Clockwork Imp uses Grind.
Artificer takes 3. Artificer takes 3. Artificer takes 3. Artificer: Context 82/100.
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.
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.
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.

