# Windmill

MCP server for Claude Code that runs scripts, workflows and manages job schedules in Windmill.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18673 repo stars
- Author: windmill-labs
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/windmill-labs/windmill
- Updated: 2026-10-25
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/windmill

## What it does

Windmill executes scripts written in Python, TypeScript, Go, and Bash while combining them into data pipelines. The MCP server grants the agent direct access to tasks, variables, and cloud resources from the coding environment.

Orchestration tools automate background execution and job monitoring.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://app.windmill.dev/api/mcp/gateway`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http windmill https://app.windmill.dev/api/mcp/gateway
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add windmill --url https://app.windmill.dev/api/mcp/gateway
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "windmill": {
            "url": "https://app.windmill.dev/api/mcp/gateway"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "windmill": {
            "type": "http",
            "url": "https://app.windmill.dev/api/mcp/gateway"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http windmill https://app.windmill.dev/api/mcp/gateway
```

## When to use it
- run scripts on remote workers
- manage job schedules and triggers
- handle system variables and resources
- connect distributed data pipelines

## Example prompts
- Run the workflow in Windmill
- Check the job status in Windmill
- List scheduled tasks from Windmill

## Similar
- [debug-hooks](https://affpapa.org/en/nevibecode/skills/debug-hooks.md) — skill · 504 installs
- [muapi-platform](https://affpapa.org/en/nevibecode/skills/muapi-platform.md) — skill · 1100 installs
- [hooks-development](https://affpapa.org/en/nevibecode/skills/hooks-development.md) — skill · 133 installs
- [neynar](https://affpapa.org/en/nevibecode/skills/neynar.md) — skill · 218 installs
- [camel-matrix](https://affpapa.org/en/nevibecode/skills/camel-matrix.md) — skill · 5700 installs
- [huggingface-tool-builder](https://affpapa.org/en/nevibecode/skills/huggingface-tool-builder.md) — skill · 1800 installs

From the same set: [windmill-labs/windmill](https://affpapa.org/en/nevibecode/by/windmill-labs/windmill.md) — 8 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
