What is the Netlify MCP server?
The Netlify MCP server is Netlify's own MCP server. It lets a code agent use the Netlify API and CLI to create projects, build, deploy and manage resources such as environment variables, forms and extensions. You run it locally with npx -y @netlify/mcp and need Node.js 22 or newer.
The repo describes it as an MCP server that lets code agents use the Netlify API and CLI. With plain-language prompts, an agent can create new projects, build and deploy them, and manage the Netlify resources attached to a site.
It runs on your machine through npx and uses your Netlify account. Netlify's README also recommends installing the Netlify CLI globally, because the server pairs with it for the best experience.
What it changes in your workflow
- Ask the agent to create a project and deploy it, instead of switching to the dashboard or remembering CLI flags.
- It can create and manage environment variables and secrets, enable form submissions and change access controls.
- It can install or uninstall Netlify extensions and fetch user and team information.
- A hosted deployment card tool, netlify-open-deployments, shows recent deploys with status, branch, errors and links in clients that support MCP Apps.
Requirements
| Netlify MCP server | |
|---|---|
| Where it runs | On your machine through npx |
| Node.js | 22 or higher |
| Account | A Netlify account |
| Recommended | The Netlify CLI installed globally with npm install -g netlify-cli |
| Auth fallback | A personal access token in NETLIFY_PERSONAL_ACCESS_TOKEN |
Who it is for
Best for
- Sites already hosted on Netlify where you want an agent to handle deploys and settings.
- Developers who prefer prompts to the dashboard for routine project setup.
- Teams that want deploy status inside an MCP Apps compatible client, then a speed check with the web performance skill.
Not for
- Sites on other hosts. It manages Netlify resources only.
- Unattended token use. The README says never to commit your token and to remove it from the config once auth works.
- Build log digging. The README says the deployment card does not include build logs or multi-project lookup yet.
Use it with UiChemy
For WordPress work, UiChemy covers the build: Composer writes HTML, CSS and JS inside Elementor or Gutenberg, and AI to WordPress imports an AI build. Use this server when the same project also has a static front end on Netlify. Click Get Started on uichemy.com. For hosting a single page, see the web design skill.
Connect Netlify MCP Server: Deploy and Manage Sites with an AI Agent to your AI client
npx -y @netlify/mcpCheck Node.js
Run node --version and use 22 or higher. The README suggests nvm install 22 and nvm use 22 if you need to switch.
Install the Netlify CLI
The README recommends npm install -g netlify-cli for the best experience.
Add the config
Paste the config above into your client's MCP file. One-click installs exist for Cursor, LM Studio, VS Code and Goose.
Sign in
Authenticate with your Netlify account. If that fails, add a personal access token as NETLIFY_PERSONAL_ACCESS_TOKEN, restart the client, and remove it once resolved.
Try a prompt
Ask the agent to show recent deployments for your project or to create and deploy a new one.
Client configuration
{
"mcpServers": {
"netlify": {
"command": "npx",
"args": ["-y", "@netlify/mcp"]
}
}
}Endpoints and ports
npx -y @netlify/mcpStarts the server over stdio.https://docs.netlify.com/welcome/build-with-ai/netlify-mcp-server/Netlify's page for the MCP server.NETLIFY_PERSONAL_ACCESS_TOKENOnly for authentication troubleshooting. Do not commit it.What you can do with it
- API and CLI accessThe server exposes both the Netlify API and CLI to the agent.
- Create and deployAgents can create new projects, build them and deploy from a prompt.
- Secrets handlingEnvironment variables and secrets can be created and managed without opening the dashboard.
- Deployment cardA card shows recent deploys, refreshes every five seconds while one is active and stops after 15 minutes.
- Status filtersTools accept a status filter that Netlify applies before limiting results.
- One-click installsThe README links one-click installs for Cursor, LM Studio, VS Code and Goose.
- Token fallbackA personal access token can unblock authentication problems, with a clear warning not to commit it.
Tools it exposes
netlify-open-deployments
Takes a siteId and optional deployId and shows up to five matching deploys with status, branch, creation time, errors and links. Needs an MCP Apps compatible client for the card; others get a text summary.
Project management
Create, manage and deploy Netlify projects through prompts, using the Netlify API and CLI.
Access controls
Modify access controls for a project.
Extensions
Install or uninstall Netlify extensions.
Environment variables and secrets
Create and manage them for a project.
Forms
Enable and manage form submissions.
User and team info
Fetch user and team information.
Frequently asked questions
What is the Netlify MCP server?
It is Netlify's MCP server that lets code agents use the Netlify API and CLI. An agent can create projects, build and deploy them, and manage resources such as environment variables, forms, access controls and extensions from natural language prompts.
How do I install the Netlify MCP server?
Add a server named netlify with command npx and args -y and @netlify/mcp to your client's MCP config. You need Node.js 22 or higher and a Netlify account. The README also recommends installing netlify-cli globally.
What Node version does Netlify MCP need?
Node.js 22 or higher. The README says to check with node --version and to use nvm install 22 followed by nvm use 22 if you manage versions with nvm. Older versions are the first thing to rule out when the server fails to start.
How do I fix Netlify MCP authentication errors?
Temporarily add a Netlify personal access token to the config as NETLIFY_PERSONAL_ACCESS_TOKEN, generated from User settings, OAuth, New access token. Restart the client, and remove the token once the problem is solved. The README warns never to commit it.
What can the Netlify MCP server deploy?
It can create new Netlify projects, build and deploy them, and manage the resources around them. The README does not list supported frameworks, so check Netlify's own documentation for what your build setup needs.
Which clients work with the Netlify MCP server?
The README names Windsurf, Cursor, Claude, Copilot in VS Code, Cline, Warp and LM Studio, and links the full list of MCP clients. One-click installs are provided for Cursor, LM Studio, VS Code and Goose.
What does the deployment card show?
In an MCP Apps compatible client, netlify-open-deployments shows up to five matching deploys with status, branch, creation time, errors and links, plus the team and dashboard link. Clients without MCP Apps support receive a text summary instead.
How can I check a Netlify deploy afterward?
The deployment card lists status, branch and errors, but not build logs. To see the live result, open the URL in a browser tool such as Chrome DevTools MCP and ask the agent to inspect console errors and failed requests on the page.


