home / mcp / netlify mcp server

Netlify MCP Server

MCP server for Netlify integration - manage Netlify sites through Model Context Protocol

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "mcerqua-netlify-mcp": {
      "command": "node",
      "args": [
        "path/to/netlify-mcp/build/index.js"
      ],
      "env": {
        "NETLIFY_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

You run a Netlify MCP Server to manage Netlify sites from your MCP-enabled environment. It lets you create sites from GitHub repos, list and inspect existing sites, and delete sites, all through a secure, TypeScript-based service that can be deployed locally or in Docker.

How to use

You interact with the Netlify MCP Server by configuring it in your MCP client settings and then invoking the server’s endpoints to perform actions such as creating new Netlify sites from GitHub repositories, listing sites with pagination, retrieving detailed site information, and deleting sites.

How to install

Prerequisites: ensure you have Node.js 18 or higher installed on your machine.

Install the server from source by cloning the repository, installing dependencies, and building the project.

# Clone the project
git clone https://github.com/MCERQUA/netlify-mcp.git
cd netlify-mcp

# Install dependencies
npm install

# Build the project
npm run build

Alternatively, you can run the server via Docker by building the image and starting a container with the Netlify access token configured.

docker build -t netlify-mcp .
docker run -e NETLIFY_ACCESS_TOKEN=your_token_here netlify-mcp

Configuration and startup details

To authenticate with Netlify, obtain a personal access token and provide it to the server via an environment variable named NETLIFY_ACCESS_TOKEN.

Add the MCP server configuration in your MCP settings to enable the Netlify MCP Server. The example below shows how to wire the local Node.js runtime to run the MCP server build output and pass the token.

{
  "mcpServers": {
    "netlify": {
      "command": "node",
      "args": ["path/to/netlify-mcp/build/index.js"],
      "env": {
        "NETLIFY_ACCESS_TOKEN": "your_token_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Security and tokens

Keep your Netlify API access token secure. Do not expose it in client-side code. Store it in a protected environment variable and reference it in the server configuration as shown.

Troubleshooting

Common issues include missing tokens, invalid tokens, or misformatted repository references. Ensure the token is set correctly in the environment, that the token has the required permissions, and that you pass repository identifiers in the expected owner/repo format.

Development

During development, you can run in development mode to enable auto-rebuilds and test changes quickly.

# Run in development mode with auto-rebuild
npm run dev

# Clean build artifacts
npm run clean

# Build the project
npm run build

Available tools

createSiteFromGitHub

Create a new Netlify site from a GitHub repository by providing a site name, repository owner/name, build command, publish directory, and optional environment variables.

listSites

List Netlify sites you have access to with optional filtering and pagination.

getSite

Retrieve detailed information about a specific Netlify site by ID or name.

deleteSite

Delete a specified Netlify site by ID or name.