Skip to main content
Windmill’s MCP server lets you interact with Windmill directly from AI coding tools like Claude Code, Claude Desktop, and Codex. Ask questions about your team, manage 1:1 agendas, check pulse results, look up feedback, and more — all from within your AI assistant. MCP (Model Context Protocol) is an open standard that lets AI tools connect to external services. By connecting Windmill’s MCP server, your AI assistant gets access to your Windmill workspace and can take actions on your behalf.
MCP access uses your individual Windmill account. You’ll authenticate with your own credentials, and all actions respect the same permissions you have in the Windmill Dashboard.

​
Connect with Claude Desktop

The recommended way to connect is with the Windmill plugin, which includes MCP tools plus additional skills for working with your Windmill data.
1

Open Customization settings

In Claude Desktop, go to Settings and select Customize.
2

Install the Windmill plugin

Go to Plugins → Create plugin → Add marketplace, then enter windmill-dev/windmill-plugin and add it.
3

Authenticate

The first time you use a Windmill tool, Claude Desktop will open your browser to authenticate with your Windmill account.
If you prefer to use the MCP server directly without the plugin, go to Settings → Customize and click Add custom connector with the following:
  • Name: Windmill
  • URL: https://mcp.gowindmill.com/mcp
  • Leave OAuth Client ID and OAuth Client Secret empty

​
Connect with Claude Code

The recommended way to connect is with the Windmill plugin, which includes MCP tools plus additional skills for working with your Windmill data. Run these commands in your terminal: 
/plugin marketplace add windmill-dev/windmill-plugin
/plugin install windmill@windmill
The first time Claude Code uses a Windmill tool, you’ll be prompted to authenticate via your browser.
If you prefer to use the MCP server directly without the plugin, run this command in your terminal:
claude mcp add --transport http windmill https://mcp.gowindmill.com/mcp
Or add this to your MCP configuration file:
{
  "windmill": {
    "type": "http",
    "url": "https://mcp.gowindmill.com/mcp"
  }
}

​
Connect with Codex

Run these commands in your terminal: 
codex mcp add windmill --url https://mcp.gowindmill.com/mcp
Then authenticate: 
codex mcp login windmill

​
What you can do

Once connected, you can ask your AI assistant questions and give it instructions that use your Windmill data. Here are some examples across Windmill’s features.

​
Employees and org chart

  • “Who reports to Sarah Chen?”
  • “How many people are on the engineering team?”
  • “Show me everyone in the Sales group”
  • “What’s Jordan’s job title and start date?“

​
1:1s

  • “What 1:1s do I have coming up this week?”
  • “Add ‘discuss Q2 goals’ to my 1:1 agenda with Alex”
  • “Show me my 1:1 notes from last week with Jamie”
  • “Create a new 1:1 with Sam Rivera”

​
Pulse surveys

  • “Show me the latest responses to our engagement pulse”
  • “Create a pulse asking the engineering team about workload”
  • “How many people have responded to the onboarding pulse?”
  • “Send a reminder nudge for the open pulse”

​
Performance reviews

  • “What review cycles are currently running?”
  • “Who’s participating in the Q1 review cycle?”
  • “Show me the reviews written for Taylor last cycle”
  • “What stage is the current review cycle in?”

​
Feedback

  • “Give feedback to Morgan: they did a great job leading the sprint retro”
  • “Request feedback from Dana about my presentation”
  • “Show me the feedback I’ve received this quarter”
  • “Give a shoutout to the design team for the rebrand launch”

​
Recaps

  • “Show me the weekly recap for Chris from last week”
  • “What has the product team been up to recently?”

​
Stats and activity

  • “Show me a breakdown of Riley’s activity across tools”
  • “What are the available stat types?”
  • “Who are my top collaborators this quarter?”

​
Workspace management

  • “How many members are in the workspace?”
  • “Invite jane@company.com to the workspace”

​
Private notes

  • “Create a note about my conversation with Pat today”
  • “Show me my notes on Alex”

​
Authentication and permissions

Windmill’s MCP server uses OAuth for authentication. The first time your AI tool calls a Windmill tool, you’ll be redirected to your browser to log in with your Windmill account. Once authenticated, all actions go through your account with the same permissions you have in the Windmill Dashboard. If you can’t see something in the dashboard, you can’t access it via MCP either.

​
FAQs

Each person sets up MCP individually in their own AI tool. There’s no admin setup required — anyone with a Windmill account can connect.
The MCP server acts as you. It has the same read and write access you have in the Windmill Dashboard. It can read data you have access to and take actions on your behalf, like giving feedback or updating a 1:1 agenda.
When you ask a question, your AI tool calls Windmill’s MCP server to fetch the relevant data, then uses that data to answer your question. The data passes through your AI tool’s model to generate a response. Windmill’s MCP server itself does not send data to any AI model — it only responds to requests from your connected tool.
Windmill’s MCP server uses the open MCP standard over HTTP with OAuth authentication. Any AI tool that supports MCP over HTTP can connect using the URL https://mcp.gowindmill.com/mcp.
Remove the Windmill MCP server from your AI tool’s configuration. In Claude Code, run claude mcp remove windmill. In Claude Desktop, remove the connector from your Customization settings.
Try removing and re-adding the MCP server, then authenticate again. Make sure you’re logging in with the same account you use to access the Windmill Dashboard.