# Windmill

> Windmill is a freemium MCP server for developer tools. Build, test, deploy and run Windmill scripts, flows and apps from an MCP client. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $20 a month
- **Platforms:** Web, API, self-hosted
- **Website:** https://www.windmill.dev/docs/core_concepts/mcp
- **Repository:** https://github.com/windmill-labs/windmill
- **MCP Registry name:** io.github.windmill-labs/windmill
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-14

## About

Windmill is a workflow and automation platform, and its MCP gateway works in two modes. As an AI session, the client gets Windmill's own tools to explore a workspace, write scripts, flows and full-code apps as drafts, test-run, diff and deploy them, and read runs, at access levels from Build and run to Read only. In the second mode, each selected script or flow becomes one typed tool and nothing else is exposed.

Connect from the Claude Connectors Directory or the ChatGPT app directory on Windmill Cloud, or add a custom connector pointing at your own instance's /api/mcp. Self-hosted instances must be reachable from OpenAI's servers for ChatGPT, and can sign clients in through your own identity provider, where admins set the workspace and access.

Windmill can also act as the MCP client in its own AI chat. The core is open source with a free edition and paid plans.

## Features

- **AI session mode:** Write, test, diff and deploy workspace items from chat.
- **Scripts as tools:** Expose chosen scripts and flows as typed tools only.
- **Access levels:** Build and run, read and run, or read only.
- **Self-hosted support:** Point clients at your own instance.
- **Identity provider sign-in:** Admins can route sign-in through their own provider.
- **Windmill as client:** Its AI chat can call external MCP servers.

## Good for

- Draft a new flow from Claude
- Expose an approved script to an agent
- Review recent job runs
- Deploy a tested script

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http windmill https://app.windmill.dev/api/mcp/gateway
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://app.windmill.dev/api/mcp/gateway
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "windmill": {
      "url": "https://app.windmill.dev/api/mcp/gateway"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "windmill": {
      "serverUrl": "https://app.windmill.dev/api/mcp/gateway"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "windmill": {
      "type": "http",
      "url": "https://app.windmill.dev/api/mcp/gateway"
    }
  }
}
```

## FAQ

### Which clients connect?

Claude, ChatGPT, Cursor or any MCP client.

### Can I use a self-hosted instance?

Yes, use your instance base URL followed by /api/mcp.

### Can I limit what the client does?

Yes, with access levels or by exposing only selected scripts and flows.

### What does Windmill cost?

A free open-source edition; paid plans list $20 per builder per month.

### Is Windmill free?

Windmill has a free plan, with paid plans for more usage or features. Paid plans start at $20 a month.

### How do I add Windmill to Claude Code?

Run this command in your terminal: claude mcp add --transport http windmill https://app.windmill.dev/api/mcp/gateway

### What are the best alternatives to Windmill?

The closest alternatives to Windmill are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/windmill
