Netlify MCP Server

Netlify's official MCP server that lets code agents create projects, deploy sites, manage environment variables, and control Netlify infrastructure.

Developer Tools by Netlify API Key active

GitHub Docs npm: @netlify/mcp

Overview

The Netlify MCP Server is the official Model Context Protocol integration maintained by Netlify. It exposes the Netlify API and CLI to AI code agents so they can create new projects, build and deploy sites, manage access controls, configure environment variables and secrets, install extensions, and inspect user and team information through natural language.

The server ships as the @netlify/mcp npm package and runs locally via npx. It authenticates by leveraging an existing Netlify CLI session (netlify login) or, as a fallback, a Netlify Personal Access Token passed through the NETLIFY_PERSONAL_ACCESS_TOKEN environment variable. It is compatible with major MCP clients including Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Goose, and Sourcegraph Amp.

Capabilities are grouped into a small number of service-level tools (user, team, project, deploy, extension, plus a coding-context helper) rather than dozens of granular endpoints. This keeps the tool surface compact while still covering the most common deployment, configuration, and management workflows on Netlify.

Tools

Tool	Description
`get-netlify-coding-context`	Returns Netlify-specific coding context and conventions used to ground other tool calls and code suggestions.
`netlify-user-services`	Fetches and manages the authenticated user's Netlify account information.
`netlify-team-services`	Manages teams and collaborative workspace operations, including team membership and team-level info.
`netlify-project-services`	Full project lifecycle management: create projects, manage environment variables and secrets, forms, and visitor access controls.
`netlify-deploy-services`	Triggers and inspects deployments, including site deploys and deployment status.
`netlify-extension-services`	Installs, uninstalls, and configures Netlify extensions, including database initialization.

Setup Guide

Prerequisites

Node.js 22 or higher
A Netlify account
Recommended: the Netlify CLI installed globally and authenticated

npm install -g netlify-cli
netlify login

Install

The server runs via npx, so no separate install is required:

npx -y @netlify/mcp

MCP client config

Add the following to your MCP client config (Claude Desktop, Cursor, VS Code, Windsurf, etc.):

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

Claude Code one-liner

claude mcp add netlify npx -- -y @netlify/mcp

Authentication

By default the server uses your existing Netlify CLI session. Verify with:

netlify status

If you hit auth issues, generate a Personal Access Token at Netlify dashboard then User settings then OAuth then New access token, and pass it via env:

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

Do not commit your PAT to a repository. Remove it from the config once CLI auth is working again.

Use Cases

Spin up a new Netlify project from an existing local repo and trigger an initial deploy without leaving the editor
Promote a preview deploy to production or roll back to a previous deploy after an incident
Bulk add or rotate environment variables and secrets across multiple Netlify projects
Install and configure Netlify extensions (such as databases) as part of an agent driven scaffolding flow
Audit team membership and access controls, and enable or inspect form submissions on a project

Example Prompts

"Create a new Netlify project from this repo and deploy the current branch as a preview."
"Set DATABASE_URL and STRIPE_SECRET_KEY as environment variables on my acme-marketing Netlify site."
"Show me the last 5 deploys for acme-marketing and roll back to the most recent successful production deploy."
"Install the Neon database extension on my Netlify team and initialize a database for the acme-api project."
"List all members of my Netlify team and tell me which sites each one owns."

Pros

Officially maintained by Netlify under the netlify GitHub org and published as @netlify/mcp
Covers the full project lifecycle: create, deploy, env vars, extensions, forms, access controls, teams
Simple npx based install with no separate hosting required
Works with all major MCP clients (Claude, Cursor, VS Code, Windsurf, Goose, Amp)

Limitations

Requires Node.js 22 or higher, which can break setups on older Node versions
Tools are grouped into broad service categories rather than fine grained endpoints, so prompts sometimes need to specify the exact sub action
Authentication can be finicky and may require falling back to a Personal Access Token

Alternatives

Vercel MCP for similar deploy and project management on Vercel
Cloudflare MCP servers for Pages and Workers infrastructure
Community Netlify MCP implementations such as DynamicEndpoints/Netlify-MCP-Server (not officially maintained)