MCP Directory

How to add Netlify MCP Server to Windsurf

Netlify's official server to create, build, deploy, and manage Netlify sites from your agent. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 320★ · stdio · apikey · official

Windsurf config for Netlify MCP Server

npx -y @netlify/mcp
{
  "mcpServers": {
    "netlify-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@netlify/mcp"
      ],
      "env": {
        "NETLIFY_PERSONAL_ACCESS_TOKEN": "<your-netlify-pat>"
      }
    }
  }
}

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Netlify MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Netlify MCP Server's tools become available to Cascade.

Before you start

  • Node.js 22 or higher (check with `node --version`)
  • An active Netlify account
  • An MCP-compatible client (Claude, Cursor, Windsurf, VS Code Copilot, Cline, Warp, LM Studio, etc.)
  • Optional: the Netlify CLI installed globally (`npm install -g netlify-cli`)
  • If browser-based auth doesn't work, a Netlify Personal Access Token (PAT) created under User settings > OAuth > New access token, supplied as NETLIFY_PERSONAL_ACCESS_TOKEN

What Netlify MCP Server can do in Windsurf

get-netlify-coding-context

Returns Netlify-specific coding context; recommended before any code-related operation

netlify-user-services

Fetch user and team account information

netlify-project-services

Full project lifecycle: create/manage projects, env vars and secrets, forms, and visitor access controls

netlify-deploy-services

Build, deploy, and retrieve deployment information for sites

netlify-extension-services

Install/uninstall Netlify extensions and initialize related services such as databases

Security

A Netlify Personal Access Token grants full control over your sites including deploys and environment variables, so treat it like a password and scope the account appropriately. Deploys triggered by the agent affect live production sites.

Netlify MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Netlify MCP Server config there under the "mcpServers" key and restart the client.

Is Netlify MCP Server safe to use with Windsurf?

A Netlify Personal Access Token grants full control over your sites including deploys and environment variables, so treat it like a password and scope the account appropriately. Deploys triggered by the agent affect live production sites.

How does authentication work?

The server uses browser-based Netlify auth by default. If that fails or you need headless operation, generate a Personal Access Token (User settings > OAuth > New access token) and pass it as NETLIFY_PERSONAL_ACCESS_TOKEN — but never commit it.

Which Node version do I need?

Node.js 22 or higher. Older versions are not supported; check with `node --version`.

Do I need the Netlify CLI installed?

Not strictly — `npx -y @netlify/mcp` fetches and runs the server on demand. Installing netlify-cli globally is optional and can help some workflows.

View repo Full Netlify MCP Server page