Skip to content

netlify/netlify-mcp

Repository files navigation

Netlify MCP Server

Netlify MCP Server follows the Model Context Protocol (MCP) to enable code agents to use the Netlify API and CLI—so they can create new projects, build, deploy, and manage your Netlify resources using natural language prompts.


Overview

The Model Context Protocol is an emerging standard protocol for connecting code agents with MCP servers, allowing them to manage resources and perform tasks using natural language. The Netlify MCP Server acts as a bridge, providing API access, CLI tools, prompts, and more for your agents.

You can connect to the Netlify MCP Server using a variety of MCP clients, including:


Use Cases

With Netlify MCP Server, your AI agents can:

  • Create, manage, and deploy Netlify projects
  • Modify access controls for enhanced project security
  • Install or uninstall Netlify extensions
  • Fetch user and team information
  • Enable and manage form submissions
  • Create and manage environment variables and secrets
  • and more...

Prerequisites

  • Node.js 22 or higher Check with node --version
  • A Netlify account
  • An MCP client (e.g., Windsurf, Cursor, Claude, Copilot)

Tip: Install the Netlify CLI globally for the best experience: npm install -g netlify-cli


MCP Configuration

For the production MCP server, use the following configuration:

Editors with one-click install:

Install MCP Server on Cursor

Install on VS Code

Install on VS Code Insiders Edition

Install on Goose

  • use the following link in your browser if link fails to render or open: goose://extension?cmd=npx&arg=-y&arg=%40netlify%2Fmcp&id=netlify&name=Netlify&description=Build%2C%20deploy%2C%20and%20manage%20sites%20with%20Netlify's%20official%20MCP%20server.

Configuration for MCP config files:

{
  "mcpServers": {
    "netlify": {
      "command": "npx",
      "args": [
        "-y",
        "@netlify/mcp"
      ]
    }
  }
}

For local development, see Set up local MCP configuration.


Troubleshooting

Node Version

  • Use Node.js 22 or higher for best results.

  • If you use nvm, run:

    nvm install 22
    nvm use 22

Netlify authentication troubleshooting

{
  "mcpServers": {
    "netlify-mcp": {
      "command": "npx",
      "args": ["-y", "@netlify/mcp"],
      "env": {
        "NETLIFY_PERSONAL_ACCESS_TOKEN": "YOUR-PAT-VALUE"
      }
    }
  }
}

Do not commit your PAT to your repository! Once resolved, remove your PAT from the config.


Generating a New Personal Access Token (PAT)

  1. In the Netlify dashboard, select your user icon.
  2. Go to User settings > OAuth > New access token.
  3. Copy your token and add it (temporarily) to your MCP config as above.
  4. Restart or refresh your MCP client.

Resources

About

Netlify's Official MCP server

Resources

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published