Skip to content
MCP server

Windmill

Build, test, deploy and run Windmill scripts, flows and apps from an MCP client

Pricing
Freemium
Platforms
Web, API, self-hosted
Runs
Remotely
Access
Needs an account or API key
Version
1.868.0
Listing updated
3 days ago

About Windmill

Windmill is a freemium MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://app.windmill.dev/api/mcp/gateway
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "windmill": {
      "url": "https://app.windmill.dev/api/mcp/gateway"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Freemium, from $20 a month

Free open-source edition; paid plans from $20 per builder per month

Prices change. Check windmill.dev before you buy.

Windmill 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 to Windmill

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity