Netlify MCP Server v2.0.0

A Model Context Protocol (MCP) server for Netlify, providing comprehensive access to ALL Netlify CLI features through the latest MCP SDK v1.12.3 and Netlify CLI v22.1.3. Now with 43 tools covering Blobs, Dev Server, Recipes, Analytics, Forms, and advanced API operations.

🚀 Latest Updates (v2.0.0 - June 2025)

Updated to MCP SDK v1.12.3 - Latest SDK with improved performance and new capabilities
Netlify CLI v22.1.3 - Latest Netlify CLI with new features and bug fixes
43 Comprehensive Tools - Complete coverage of Netlify CLI including Blobs, Dev Server, Recipes
Netlify Blobs Support - Full blob storage management (get, set, delete, list)
Dev Server Integration - Local development server tools for testing
Recipe System - Access to Netlify's automation recipes
Advanced API Access - Direct Netlify API calls and method discovery
Enhanced Analytics - Site analytics and performance monitoring
Form Management - Complete form and submission handling
Real-time Monitoring - Live log streaming and deployment watching
Account Management - Multi-account switching and management
Improved Resource System - Better resource handling with JSON output
Smart Prompts - Pre-built prompts for common Netlify workflows
Better Error Handling - More robust error reporting and recovery
Modern TypeScript Configuration - Updated to latest TypeScript best practices

✨ Enhanced Features (NEW!)

🎯 AI-Optimized Workflow Prompts

28 comprehensive workflow templates designed specifically for AI coding agents:

netlify-deploy - Complete deployment with validation and monitoring
netlify-setup - Full site setup from creation to production
netlify-environment-setup - Environment configuration across contexts
netlify-troubleshoot - Comprehensive issue diagnosis and resolution
netlify-function-deploy - Function deployment with best practices
netlify-migration - Site migration with optimization
netlify-optimization - Performance, security, and SEO optimization
netlify-security-audit - Complete security audit and hardening
netlify-performance-audit - Comprehensive performance analysis and optimization
netlify-edge-functions-setup - Edge functions deployment and configuration
netlify-blobs-management - Comprehensive blob storage management workflow
netlify-forms-setup - Form handling and submission management setup
netlify-analytics-dashboard - Analytics dashboard setup and monitoring
netlify-domain-setup - Custom domain configuration and DNS management
netlify-redirects-config - URL redirects and rewrite rules configuration
netlify-build-optimization - Build process optimization and caching
netlify-monitoring-setup - Comprehensive monitoring and alerting setup
netlify-backup-strategy - Site backup and disaster recovery planning
netlify-team-collaboration - Team workflow and collaboration setup
netlify-api-integration - API integration and webhook configuration
netlify-staging-workflow - Staging environment and preview deployment workflow
netlify-seo-optimization - SEO optimization and search engine visibility
netlify-cdn-optimization - CDN and edge network optimization
netlify-compliance-audit - Compliance and accessibility audit
netlify-cost-optimization - Cost analysis and optimization recommendations
netlify-disaster-recovery - Disaster recovery testing and procedures
netlify-advanced-deployment - Advanced deployment strategies and blue-green deployments

📊 Comprehensive Resources with Real-time Subscriptions

32 enhanced data sources with live updates:

Site Resources: Overview, functions, environment variables, deploys, forms, analytics, logs, edge functions, domains, redirects, headers, performance, security, bandwidth, errors
Blob Storage: Complete blob storage management and data access
Recipes & API: Automation recipes and direct API method access
Account Resources: Usage statistics, team information, billing, members, integrations, tokens, notifications
Global Resources: Service status, deployment regions, and system health
Real-time Features: Live subscriptions, automatic cache invalidation, event notifications

🔄 Advanced Subscription System

Subscribe to any resource URI for real-time updates
Automatic cache management with intelligent refresh
Targeted notifications based on change types
Retry logic for failed notifications

Features

🛠️ Comprehensive Netlify CLI Coverage (43 Tools)

Complete Netlify functionality at your fingertips:

🚀 Deployment & Build Management - Deploy, build, trigger, and monitor deployments
🏗️ Site Administration - Create, manage, and configure Netlify sites
⚙️ Environment Management - Full environment variable control and cloning
📦 Netlify Blobs Storage - Complete blob storage operations (get, set, delete, list)
⚡ Serverless Functions - Build, invoke, and monitor function execution
🔧 Development Tools - Local dev server and built site serving
🤖 Recipe Automation - Access to Netlify's automation recipes
📊 Analytics & Monitoring - Site analytics, real-time logs, and performance data
📋 Form Management - Handle forms and submissions
🔌 Direct API Access - Make direct Netlify API calls with method discovery
👥 Account Management - Multi-account switching and team management

🛠️ Tools (43 Available)

Core Deployment

deploy-site - Deploy a site to Netlify (production or preview)
trigger-build - Trigger a new build and deploy
build-site - Build site locally with context options

Environment Variables

set-env-vars - Set environment variables for a site
get-env-var - Get a specific environment variable
unset-env-var - Unset an environment variable
clone-env-vars - Clone environment variables between sites
import-env - Import environment variables from file

Deployments & History

list-deploys - List deploys for a site
get-deploy-info - Get information about a specific deploy
cancel-deploy - Cancel a running deploy
restore-deploy - Restore a previous deploy
watch-deploy - Watch deployment progress in real-time

Functions & Edge Functions

list-functions - List all functions for a site
get-logs - Get function logs for a site
build-function - Build a serverless function
invoke-function-advanced - Invoke function with advanced options

Netlify Blobs (Storage)

get-blob - Get a blob from Netlify Blobs storage
set-blob - Set/store a blob in Netlify Blobs storage
delete-blob - Delete a blob from storage
list-blobs - List all blobs in a store

Development & Testing

start-dev-server - Start Netlify dev server locally
serve-built-site - Serve a built site locally

Recipes & Automation

list-recipes - List available Netlify recipes
run-recipe - Run a specific Netlify recipe

API & Advanced Operations

call-netlify-api - Make direct Netlify API calls
list-api-methods - List available API methods

Forms & Analytics

get-form-submissions - Get form submissions for a site
manage-form - Manage site forms and submissions
get-analytics - Get site analytics data

Monitoring & Logs

stream-logs - Stream real-time logs from functions
enable-branch-deploy - Enable branch deploys for a specific branch
disable-branch-deploy - Disable branch deploys for a specific branch

Account Management

switch-account - Switch between Netlify accounts

📋 Resources (32 Available)

netlify://sites - List all sites (JSON)
netlify://sites/{siteId}/overview - Complete site overview with functions, deployments, and analytics
netlify://sites/{siteId}/functions - List site functions (JSON)
netlify://sites/{siteId}/env - List environment variables (JSON)
netlify://sites/{siteId}/deploys - List site deployments (JSON)
netlify://sites/{siteId}/deploys/{deployId} - Detailed information about a specific deployment
netlify://sites/{siteId}/forms - Form submissions and configuration
netlify://sites/{siteId}/analytics - Site usage analytics and performance metrics
netlify://sites/{siteId}/logs - Recent site and function logs
netlify://sites/{siteId}/edge-functions - List and manage edge functions for a site
netlify://sites/{siteId}/build-hooks - Manage build hooks and webhook configurations
netlify://sites/{siteId}/domains - Custom domains and DNS configuration
netlify://sites/{siteId}/redirects - URL redirects and rewrite rules
netlify://sites/{siteId}/headers - Custom HTTP headers configuration
netlify://sites/{siteId}/performance - Site performance analytics and optimization data
netlify://sites/{siteId}/security - Security headers, SSL, and vulnerability analysis
netlify://sites/{siteId}/bandwidth - Site bandwidth consumption and analytics
netlify://sites/{siteId}/errors - Site error logs and exception tracking
netlify://blobs/{storeName} - Netlify Blobs storage management
netlify://blobs/{storeName}/{key} - Individual blob data and metadata
netlify://recipes - Netlify automation recipes and templates
netlify://recipes/{recipeName} - Detailed recipe configuration and steps
netlify://api/methods - Available Netlify API endpoints and methods
netlify://account/usage - Account-level usage statistics and limits
netlify://account/teams - Team membership and permissions
netlify://account/billing - Account billing details and usage costs
netlify://account/members - Team member management and permissions
netlify://account/integrations - Connected services and integrations
netlify://account/tokens - Personal access tokens and API keys
netlify://account/notifications - Email and webhook notification preferences
netlify://global/regions - Available deployment regions and edge locations
netlify://status - Current Netlify service status and health

💡 Smart Prompts (28 Available)

netlify-deploy - Deploy a site with best practices guidance
netlify-setup - Set up a new Netlify site with configuration
netlify-environment-setup - Environment configuration across contexts
netlify-troubleshoot - Comprehensive issue diagnosis and resolution
netlify-function-deploy - Function deployment with best practices
netlify-migration - Site migration with optimization
netlify-optimization - Performance, security, and SEO optimization
netlify-security-audit - Complete security audit and hardening
netlify-performance-audit - Comprehensive performance analysis and optimization
netlify-edge-functions-setup - Edge functions deployment and configuration
netlify-blobs-management - Comprehensive blob storage management workflow
netlify-forms-setup - Form handling and submission management setup
netlify-analytics-dashboard - Analytics dashboard setup and monitoring
netlify-domain-setup - Custom domain configuration and DNS management
netlify-redirects-config - URL redirects and rewrite rules configuration
netlify-build-optimization - Build process optimization and caching
netlify-monitoring-setup - Comprehensive monitoring and alerting setup
netlify-backup-strategy - Site backup and disaster recovery planning
netlify-team-collaboration - Team workflow and collaboration setup
netlify-api-integration - API integration and webhook configuration
netlify-staging-workflow - Staging environment and preview deployment workflow
netlify-seo-optimization - SEO optimization and search engine visibility
netlify-cdn-optimization - CDN and edge network optimization
netlify-compliance-audit - Compliance and accessibility audit
netlify-cost-optimization - Cost analysis and optimization recommendations
netlify-disaster-recovery - Disaster recovery testing and procedures
netlify-advanced-deployment - Advanced deployment strategies and blue-green deployments

Installation

Installing via Smithery

To install Netlify MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @DynamicEndpoints/Netlify-MCP-Server --client claude

Manual Installation

Clone this repository:

git clone <repository-url>
cd Netlify-MCP-Server

Install dependencies:

npm install

Build the project:

npm run build

Ensure Netlify CLI is installed (latest version):

npm install -g netlify-cli@latest

Authentication

This MCP server interacts with the Netlify CLI, which requires authentication with your Netlify account. Since the server runs non-interactively, you must use a Personal Access Token (PAT).

Generate a PAT:
- Go to your Netlify User Settings > Applications > Personal access tokens (Direct Link)
- Select New access token
- Give it a description (e.g., "MCP Server Token")
- Set an expiration date
- Select Generate token
- Copy the token immediately and store it securely
Configure the Token: You need to make this token available to the MCP server as the NETLIFY_AUTH_TOKEN environment variable. Add it to the env section of the server's configuration in your MCP settings file (see below).

Note: Using netlify login is not suitable for this server as it requires interactive browser authentication.

Configuration

Add the following configuration to your MCP settings file, replacing "YOUR_NETLIFY_PAT_HERE" with your actual Personal Access Token:

{
  "mcpServers": {
    "netlify": {
      "command": "node",
      "args": ["C:\\path\\to\\Netlify-MCP-Server\\build\\index.js"],
      "env": {
        "NETLIFY_AUTH_TOKEN": "YOUR_NETLIFY_PAT_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Settings file locations:

Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
Other MCP clients: Consult your specific MCP client documentation

Available Tools (Netlify CLI v22.1.3 Compatible)

(Parameters are based on the Zod schemas defined in src/index.ts)

Site & Deployment Management

deploy-site

Deploy a site directory to Netlify.

{
  "path": "string",        // Required: Path to the site directory
  "prod": "boolean?",      // Optional: Deploy to production
  "message": "string?"     // Optional: Deploy message
}

Example:

{
  "path": "./dist",
  "prod": true,
  "message": "Deploying latest changes"
}

list-sites

List all Netlify sites linked to your account.

{} // No parameters

Example:

{}

trigger-build

Trigger a new build/deploy for a site. Site context is passed via NETLIFY_SITE_ID env var.

{
  "siteId": "string",     // Required: Site ID or name
  "message": "string?"    // Optional: Deploy message
}

Example:

{
  "siteId": "your-site-id-here",
  "message": "Triggering rebuild"
}

build-site

Run a Netlify build locally (mimics Netlify build environment). Site context is passed via NETLIFY_SITE_ID env var if siteId is provided.

{
  "siteId": "string?",    // Optional: Site ID (if project dir not linked)
  "context": "string?",   // Optional: Build context (e.g., 'production', 'deploy-preview')
  "dry": "boolean?"       // Optional: Run a dry build (list steps without executing)
}

Example:

{
  "siteId": "your-site-id-here",
  "context": "production"
}

link-site

Link the current project directory to a Netlify site (requires Site ID for non-interactive use).

{
  "siteId": "string"     // Required: Site ID to link to.
}

Example:

{
  "siteId": "your-site-id-here"
}

unlink-site

Unlink the current project directory from the associated Netlify site.

{} // No parameters

Example:

{}

get-status

Show the Netlify status for the linked site/directory. (Will likely fail if run via MCP server unless the server directory itself is linked).

{} // No parameters

Example:

{}

create-site

Create a new site on Netlify (non-interactively).

{
  "name": "string?",        // Optional: Site name (subdomain)
  "accountSlug": "string?"  // Optional: Account slug for the team (defaults to 'playhousehosting' if omitted)
}

Example:

{
  "name": "my-awesome-new-site"
}

delete-site

Delete a site from Netlify.

{
  "siteId": "string",     // Required: Site ID to delete
  "force": "boolean?"     // Optional: Force deletion without confirmation (default: true)
}

Example:

{
  "siteId": "site-id-to-delete",
  "force": true
}

Advanced Site Management

init-site

Initialize a new site in the current directory.

{
  "name": "string?",        // Optional: Site name
  "accountSlug": "string?", // Optional: Account slug
  "manual": "boolean?"      // Optional: Skip git detection
}

Example:

{
  "name": "my-new-site",
  "manual": true
}

open-site

Open site in browser.

{
  "siteId": "string?",     // Optional: Site ID (if not linked)
  "admin": "boolean?"      // Optional: Open admin panel instead of site
}

Example:

{
  "siteId": "your-site-id-here",
  "admin": true
}

watch-deploy

Watch deployment progress in real-time.

{
  "siteId": "string",      // Required: Site ID
  "deployId": "string?"    // Optional: Specific deploy ID to watch
}

Example:

{
  "siteId": "your-site-id-here",
  "deployId": "deploy-id-123"
}

Environment Variable Management

set-env-vars

Set one or more environment variables for a site. Site context is passed via NETLIFY_SITE_ID env var.

{
  "siteId": "string",     // Required: Site ID or name
  "envVars": {            // Required: Object of key-value pairs
    "KEY": "value"
  }
}

Example:

{
  "siteId": "your-site-id-here",
  "envVars": {
    "API_KEY": "secret123",
    "NODE_ENV": "production"
  }
}

get-env-var

Get the value of a specific environment variable. Site context is passed via NETLIFY_SITE_ID env var if siteId is provided.

{
  "siteId": "string?",    // Optional: Site ID (if not linked)
  "key": "string",        // Required: The environment variable key
  "context": "string?",   // Optional: Specific context (e.g., 'production')
  "scope": "string?"      // Optional: Specific scope (e.g., 'builds', 'functions')
}

Example:

{
  "siteId": "your-site-id-here",
  "key": "API_KEY"
}

unset-env-var

Unset (delete) an environment variable. Site context is passed via NETLIFY_SITE_ID env var if siteId is provided.

{
  "siteId": "string?",    // Optional: Site ID (if not linked)
  "key": "string",        // Required: The environment variable key
  "context": "string?"    // Optional: Specific context to unset from (otherwise all)
}

Example:

{
  "siteId": "your-site-id-here",
  "key": "OLD_VAR"
}

import-env

Import environment variables from a .env file. Site context is passed via NETLIFY_SITE_ID env var.

{
  "siteId": "string",     // Required: Site ID or name
  "filePath": "string",   // Required: Path to the .env file
  "replace": "boolean?"   // Optional: Replace existing variables instead of merging
}

Example:

{
  "siteId": "your-site-id-here",
  "filePath": ".env.production",
  "replace": true
}

clone-env-vars

Clone environment variables from one site to another. Requires source site to be linked or specified via NETLIFY_SITE_ID.

{
  "fromSiteId": "string", // Required: Source Site ID
  "toSiteId": "string"    // Required: Destination Site ID
}

Example:

{
  "fromSiteId": "source-site-id",
  "toSiteId": "destination-site-id"
}

Serverless Functions

get-logs

View function logs. Site context is passed via NETLIFY_SITE_ID env var.

{
  "siteId": "string",     // Required: Site ID or name
  "function": "string?"   // Optional: Specific function name to filter logs
}

Example:

{
  "siteId": "your-site-id-here",
  "function": "my-serverless-func"
}

Available Resources (Netlify CLI v22.1.3 Compatible)

Access Netlify data directly using these resource URIs:

netlify://sites: List all sites (JSON output of sites:list --json)
netlify://sites/{siteId}/functions: List functions for a site (JSON output of functions:list --json, requires NETLIFY_SITE_ID={siteId} env var)
netlify://sites/{siteId}/env: List environment variables for a site (JSON output of env:list --json, requires NETLIFY_SITE_ID={siteId} env var)
netlify://sites/{siteId}/deploys: List deployments for a site (JSON output of deploys:list --json, requires NETLIFY_SITE_ID={siteId} env var)
netlify://sites/{siteId}/forms: List forms for a site (JSON output from form management tools)
netlify://sites/{siteId}/analytics: Site analytics data (JSON output from analytics tools)
netlify://blobs/{storeName}: List blobs in a store (JSON output from blob storage tools)
netlify://recipes: List available recipes (JSON output from recipe tools)
netlify://api/methods: List available API methods (JSON output from API discovery tools)

Limitations (Netlify CLI v22.1.3)

Interactive Commands: Commands requiring interactive prompts (like netlify login, netlify init without parameters, interactive dev mode) are not supported by this server. Use a Personal Access Token for authentication and provide required parameters explicitly.
Site Context: Many commands require site context. This server passes the required siteId via the NETLIFY_SITE_ID environment variable when executing these commands. Commands that operate on the current working directory (like status and unlink) may not function as expected when called via the MCP server unless the server directory is properly linked.
Browser-dependent Features: Some commands that require opening browsers or interactive authentication flows may have limited functionality in the MCP server environment.
Real-time Streaming: While log streaming is supported, the output is captured and returned rather than providing a true real-time stream interface.

Note: This comprehensive implementation now covers all major Netlify CLI functionality including Blobs, Dev Server, Recipes, Analytics, Forms, and advanced API operations. Previously unsupported features like DNS, Plugins, and Hooks may still have limited support depending on CLI capabilities.

Development

To modify the server:

Update source code in src/index.ts.
Build with npm run build.
Restart the MCP server in your client application to load changes.
Test your changes.

Resources

Netlify MCP Server v2.0.0

🚀 Latest Updates (v2.0.0 - June 2025)

Updated to MCP SDK v1.12.3 - Latest SDK with improved performance and new capabilities
Netlify CLI v22.1.3 - Latest Netlify CLI with new features and bug fixes
43 Comprehensive Tools - Complete coverage of Netlify CLI including Blobs, Dev Server, Recipes
Netlify Blobs Support - Full blob storage management (get, set, delete, list)
Dev Server Integration - Local development server tools for testing
Recipe System - Access to Netlify's automation recipes
Advanced API Access - Direct Netlify API calls and method discovery
Enhanced Analytics - Site analytics and performance monitoring
Form Management - Complete form and submission handling
Real-time Monitoring - Live log streaming and deployment watching
Account Management - Multi-account switching and management
Improved Resource System - Better resource handling with JSON output
Smart Prompts - Pre-built prompts for common Netlify workflows
Better Error Handling - More robust error reporting and recovery
Modern TypeScript Configuration - Updated to latest TypeScript best practices

✨ Enhanced Features (NEW!)

🎯 AI-Optimized Workflow Prompts

28 comprehensive workflow templates designed specifically for AI coding agents:

netlify-deploy - Complete deployment with validation and monitoring
netlify-setup - Full site setup from creation to production
netlify-environment-setup - Environment configuration across contexts
netlify-troubleshoot - Comprehensive issue diagnosis and resolution
netlify-function-deploy - Function deployment with best practices
netlify-migration - Site migration with optimization
netlify-optimization - Performance, security, and SEO optimization
netlify-security-audit - Complete security audit and hardening
netlify-performance-audit - Comprehensive performance analysis and optimization
netlify-edge-functions-setup - Edge functions deployment and configuration
netlify-blobs-management - Comprehensive blob storage management workflow
netlify-forms-setup - Form handling and submission management setup
netlify-analytics-dashboard - Analytics dashboard setup and monitoring
netlify-domain-setup - Custom domain configuration and DNS management
netlify-redirects-config - URL redirects and rewrite rules configuration
netlify-build-optimization - Build process optimization and caching
netlify-monitoring-setup - Comprehensive monitoring and alerting setup
netlify-backup-strategy - Site backup and disaster recovery planning
netlify-team-collaboration - Team workflow and collaboration setup
netlify-api-integration - API integration and webhook configuration
netlify-staging-workflow - Staging environment and preview deployment workflow
netlify-seo-optimization - SEO optimization and search engine visibility
netlify-cdn-optimization - CDN and edge network optimization
netlify-compliance-audit - Compliance and accessibility audit
netlify-cost-optimization - Cost analysis and optimization recommendations
netlify-disaster-recovery - Disaster recovery testing and procedures
netlify-advanced-deployment - Advanced deployment strategies and blue-green deployments

📊 Comprehensive Resources with Real-time Subscriptions

32 enhanced data sources with live updates:

Site Resources: Overview, functions, environment variables, deploys, forms, analytics, logs, edge functions, domains, redirects, headers, performance, security, bandwidth, errors
Blob Storage: Complete blob storage management and data access
Recipes & API: Automation recipes and direct API method access
Account Resources: Usage statistics, team information, billing, members, integrations, tokens, notifications
Global Resources: Service status, deployment regions, and system health
Real-time Features: Live subscriptions, automatic cache invalidation, event notifications

🔄 Advanced Subscription System

Subscribe to any resource URI for real-time updates
Automatic cache management with intelligent refresh
Targeted notifications based on change types
Retry logic for failed notifications

Features

🛠️ Comprehensive Netlify CLI Coverage (43 Tools)

Complete Netlify functionality at your fingertips:

🚀 Deployment & Build Management - Deploy, build, trigger, and monitor deployments
🏗️ Site Administration - Create, manage, and configure Netlify sites
⚙️ Environment Management - Full environment variable control and cloning
📦 Netlify Blobs Storage - Complete blob storage operations (get, set, delete, list)
⚡ Serverless Functions - Build, invoke, and monitor function execution
🔧 Development Tools - Local dev server and built site serving
🤖 Recipe Automation - Access to Netlify's automation recipes
📊 Analytics & Monitoring - Site analytics, real-time logs, and performance data
📋 Form Management - Handle forms and submissions
🔌 Direct API Access - Make direct Netlify API calls with method discovery
👥 Account Management - Multi-account switching and team management

🛠️ Tools (43 Available)

Core Deployment

deploy-site - Deploy a site to Netlify (production or preview)
trigger-build - Trigger a new build and deploy
build-site - Build site locally with context options

Environment Variables

set-env-vars - Set environment variables for a site
get-env-var - Get a specific environment variable
unset-env-var - Unset an environment variable
clone-env-vars - Clone environment variables between sites
import-env - Import environment variables from file

Deployments & History

list-deploys - List deploys for a site
get-deploy-info - Get information about a specific deploy
cancel-deploy - Cancel a running deploy
restore-deploy - Restore a previous deploy
watch-deploy - Watch deployment progress in real-time

Functions & Edge Functions

list-functions - List all functions for a site
get-logs - Get function logs for a site
build-function - Build a serverless function
invoke-function-advanced - Invoke function with advanced options

Netlify Blobs (Storage)

get-blob - Get a blob from Netlify Blobs storage
set-blob - Set/store a blob in Netlify Blobs storage
delete-blob - Delete a blob from storage
list-blobs - List all blobs in a store

Development & Testing

start-dev-server - Start Netlify dev server locally
serve-built-site - Serve a built site locally

Recipes & Automation

list-recipes - List available Netlify recipes
run-recipe - Run a specific Netlify recipe

API & Advanced Operations

call-netlify-api - Make direct Netlify API calls
list-api-methods - List available API methods

Forms & Analytics

get-form-submissions - Get form submissions for a site
manage-form - Manage site forms and submissions
get-analytics - Get site analytics data

Monitoring & Logs

stream-logs - Stream real-time logs from functions
enable-branch-deploy - Enable branch deploys for a specific branch
disable-branch-deploy - Disable branch deploys for a specific branch

Account Management

switch-account - Switch between Netlify accounts

📋 Resources (32 Available)

netlify://sites - List all sites (JSON)
netlify://sites/{siteId}/overview - Complete site overview with functions, deployments, and analytics
netlify://sites/{siteId}/functions - List site functions (JSON)
netlify://sites/{siteId}/env - List environment variables (JSON)
netlify://sites/{siteId}/deploys - List site deployments (JSON)
netlify://sites/{siteId}/deploys/{deployId} - Detailed information about a specific deployment
netlify://sites/{siteId}/forms - Form submissions and configuration
netlify://sites/{siteId}/analytics - Site usage analytics and performance metrics
netlify://sites/{siteId}/logs - Recent site and function logs
netlify://sites/{siteId}/edge-functions - List and manage edge functions for a site
netlify://sites/{siteId}/build-hooks - Manage build hooks and webhook configurations
netlify://sites/{siteId}/domains - Custom domains and DNS configuration
netlify://sites/{siteId}/redirects - URL redirects and rewrite rules
netlify://sites/{siteId}/headers - Custom HTTP headers configuration
netlify://sites/{siteId}/performance - Site performance analytics and optimization data
netlify://sites/{siteId}/security - Security headers, SSL, and vulnerability analysis
netlify://sites/{siteId}/bandwidth - Site bandwidth consumption and analytics
netlify://sites/{siteId}/errors - Site error logs and exception tracking
netlify://blobs/{storeName} - Netlify Blobs storage management
netlify://blobs/{storeName}/{key} - Individual blob data and metadata
netlify://recipes - Netlify automation recipes and templates
netlify://recipes/{recipeName} - Detailed recipe configuration and steps
netlify://api/methods - Available Netlify API endpoints and methods
netlify://account/usage - Account-level usage statistics and limits
netlify://account/teams - Team membership and permissions
netlify://account/billing - Account billing details and usage costs
netlify://account/members - Team member management and permissions
netlify://account/integrations - Connected services and integrations
netlify://account/tokens - Personal access tokens and API keys
netlify://account/notifications - Email and webhook notification preferences
netlify://global/regions - Available deployment regions and edge locations
netlify://status - Current Netlify service status and health

💡 Smart Prompts (28 Available)

netlify-deploy - Deploy a site with best practices guidance
netlify-setup - Set up a new Netlify site with configuration
netlify-environment-setup - Environment configuration across contexts
netlify-troubleshoot - Comprehensive issue diagnosis and resolution
netlify-function-deploy - Function deployment with best practices
netlify-migration - Site migration with optimization
netlify-optimization - Performance, security, and SEO optimization
netlify-security-audit - Complete security audit and hardening
netlify-performance-audit - Comprehensive performance analysis and optimization
netlify-edge-functions-setup - Edge functions deployment and configuration
netlify-blobs-management - Comprehensive blob storage management workflow
netlify-forms-setup - Form handling and submission management setup
netlify-analytics-dashboard - Analytics dashboard setup and monitoring
netlify-domain-setup - Custom domain configuration and DNS management
netlify-redirects-config - URL redirects and rewrite rules configuration
netlify-build-optimization - Build process optimization and caching
netlify-monitoring-setup - Comprehensive monitoring and alerting setup
netlify-backup-strategy - Site backup and disaster recovery planning
netlify-team-collaboration - Team workflow and collaboration setup
netlify-api-integration - API integration and webhook configuration
netlify-staging-workflow - Staging environment and preview deployment workflow
netlify-seo-optimization - SEO optimization and search engine visibility
netlify-cdn-optimization - CDN and edge network optimization
netlify-compliance-audit - Compliance and accessibility audit
netlify-cost-optimization - Cost analysis and optimization recommendations
netlify-disaster-recovery - Disaster recovery testing and procedures
netlify-advanced-deployment - Advanced deployment strategies and blue-green deployments

Installation

Installing via Smithery

To install Netlify MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @DynamicEndpoints/Netlify-MCP-Server --client claude

Manual Installation

Clone this repository:

git clone <repository-url>
cd Netlify-MCP-Server

Install dependencies:

npm install

Build the project:

npm run build

Ensure Netlify CLI is installed (latest version):

npm install -g netlify-cli@latest

Authentication

This MCP server interacts with the Netlify CLI, which requires authentication with your Netlify account. Since the server runs non-interactively, you must use a Personal Access Token (PAT).

Generate a PAT:
- Go to your Netlify User Settings > Applications > Personal access tokens (Direct Link)
- Select New access token
- Give it a description (e.g., "MCP Server Token")
- Set an expiration date
- Select Generate token
- Copy the token immediately and store it securely
Configure the Token: You need to make this token available to the MCP server as the NETLIFY_AUTH_TOKEN environment variable. Add it to the env section of the server's configuration in your MCP settings file (see below).

Note: Using netlify login is not suitable for this server as it requires interactive browser authentication.

Configuration

Add the following configuration to your MCP settings file, replacing "YOUR_NETLIFY_PAT_HERE" with your actual Personal Access Token:

{
  "mcpServers": {
    "netlify": {
      "command": "node",
      "args": ["C:\\path\\to\\Netlify-MCP-Server\\build\\index.js"],
      "env": {
        "NETLIFY_AUTH_TOKEN": "YOUR_NETLIFY_PAT_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Settings file locations:

Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
Other MCP clients: Consult your specific MCP client documentation

Available Tools (Netlify CLI v22.1.3 Compatible)

(Parameters are based on the Zod schemas defined in src/index.ts)

Site & Deployment Management

deploy-site

Deploy a site directory to Netlify.

{
  "path": "string",        // Required: Path to the site directory
  "prod": "boolean?",      // Optional: Deploy to production
  "message": "string?"     // Optional: Deploy message
}

Example:

{
  "path": "./dist",
  "prod": true,
  "message": "Deploying latest changes"
}

list-sites

List all Netlify sites linked to your account.

{} // No parameters

Example:

{}

trigger-build

Trigger a new build/deploy for a site. Site context is passed via NETLIFY_SITE_ID env var.

{
  "siteId": "string",     // Required: Site ID or name
  "message": "string?"    // Optional: Deploy message
}

Example:

{
  "siteId": "your-site-id-here",
  "message": "Triggering rebuild"
}

build-site

Run a Netlify build locally (mimics Netlify build environment). Site context is passed via NETLIFY_SITE_ID env var if siteId is provided.

{
  "siteId": "string?",    // Optional: Site ID (if project dir not linked)
  "context": "string?",   // Optional: Build context (e.g., 'production', 'deploy-preview')
  "dry": "boolean?"       // Optional: Run a dry build (list steps without executing)
}

Example:

{
  "siteId": "your-site-id-here",
  "context": "production"
}

link-site

Link the current project directory to a Netlify site (requires Site ID for non-interactive use).

{
  "siteId": "string"     // Required: Site ID to link to.
}

Example:

{
  "siteId": "your-site-id-here"
}

unlink-site

Unlink the current project directory from the associated Netlify site.

{} // No parameters

Example:

{}

get-status

Show the Netlify status for the linked site/directory. (Will likely fail if run via MCP server unless the server directory itself is linked).

{} // No parameters

Example:

{}

create-site

Create a new site on Netlify (non-interactively).

{
  "name": "string?",        // Optional: Site name (subdomain)
  "accountSlug": "string?"  // Optional: Account slug for the team (defaults to 'playhousehosting' if omitted)
}

Example:

{
  "name": "my-awesome-new-site"
}

delete-site

Delete a site from Netlify.

{
  "siteId": "string",     // Required: Site ID to delete
  "force": "boolean?"     // Optional: Force deletion without confirmation (default: true)
}

Example:

{
  "siteId": "site-id-to-delete",
  "force": true
}

Advanced Site Management

init-site

Initialize a new site in the current directory.

{
  "name": "string?",        // Optional: Site name
  "accountSlug": "string?", // Optional: Account slug
  "manual": "boolean?"      // Optional: Skip git detection
}

Example:

{
  "name": "my-new-site",
  "manual": true
}

open-site

Open site in browser.

{
  "siteId": "string?",     // Optional: Site ID (if not linked)
  "admin": "boolean?"      // Optional: Open admin panel instead of site
}

Example:

{
  "siteId": "your-site-id-here",
  "admin": true
}

watch-deploy

Watch deployment progress in real-time.

{
  "siteId": "string",      // Required: Site ID
  "deployId": "string?"    // Optional: Specific deploy ID to watch
}

Example:

{
  "siteId": "your-site-id-here",
  "deployId": "deploy-id-123"
}

Environment Variable Management

set-env-vars

Set one or more environment variables for a site. Site context is passed via NETLIFY_SITE_ID env var.

{
  "siteId": "string",     // Required: Site ID or name
  "envVars": {            // Required: Object of key-value pairs
    "KEY": "value"
  }
}

Example:

{
  "siteId": "your-site-id-here",
  "envVars": {
    "API_KEY": "secret123",
    "NODE_ENV": "production"
  }
}

get-env-var

Get the value of a specific environment variable. Site context is passed via NETLIFY_SITE_ID env var if siteId is provided.

{
  "siteId": "string?",    // Optional: Site ID (if not linked)
  "key": "string",        // Required: The environment variable key
  "context": "string?",   // Optional: Specific context (e.g., 'production')
  "scope": "string?"      // Optional: Specific scope (e.g., 'builds', 'functions')
}

Example:

{
  "siteId": "your-site-id-here",
  "key": "API_KEY"
}

unset-env-var

Unset (delete) an environment variable. Site context is passed via NETLIFY_SITE_ID env var if siteId is provided.

{
  "siteId": "string?",    // Optional: Site ID (if not linked)
  "key": "string",        // Required: The environment variable key
  "context": "string?"    // Optional: Specific context to unset from (otherwise all)
}

Example:

{
  "siteId": "your-site-id-here",
  "key": "OLD_VAR"
}

import-env

Import environment variables from a .env file. Site context is passed via NETLIFY_SITE_ID env var.

{
  "siteId": "string",     // Required: Site ID or name
  "filePath": "string",   // Required: Path to the .env file
  "replace": "boolean?"   // Optional: Replace existing variables instead of merging
}

Example:

{
  "siteId": "your-site-id-here",
  "filePath": ".env.production",
  "replace": true
}

clone-env-vars

Clone environment variables from one site to another. Requires source site to be linked or specified via NETLIFY_SITE_ID.

{
  "fromSiteId": "string", // Required: Source Site ID
  "toSiteId": "string"    // Required: Destination Site ID
}

Example:

{
  "fromSiteId": "source-site-id",
  "toSiteId": "destination-site-id"
}

Serverless Functions

get-logs

View function logs. Site context is passed via NETLIFY_SITE_ID env var.

{
  "siteId": "string",     // Required: Site ID or name
  "function": "string?"   // Optional: Specific function name to filter logs
}

Example:

{
  "siteId": "your-site-id-here",
  "function": "my-serverless-func"
}

Available Resources (Netlify CLI v22.1.3 Compatible)

Access Netlify data directly using these resource URIs:

netlify://sites: List all sites (JSON output of sites:list --json)
netlify://sites/{siteId}/functions: List functions for a site (JSON output of functions:list --json, requires NETLIFY_SITE_ID={siteId} env var)
netlify://sites/{siteId}/env: List environment variables for a site (JSON output of env:list --json, requires NETLIFY_SITE_ID={siteId} env var)
netlify://sites/{siteId}/deploys: List deployments for a site (JSON output of deploys:list --json, requires NETLIFY_SITE_ID={siteId} env var)
netlify://sites/{siteId}/forms: List forms for a site (JSON output from form management tools)
netlify://sites/{siteId}/analytics: Site analytics data (JSON output from analytics tools)
netlify://blobs/{storeName}: List blobs in a store (JSON output from blob storage tools)
netlify://recipes: List available recipes (JSON output from recipe tools)
netlify://api/methods: List available API methods (JSON output from API discovery tools)

Limitations (Netlify CLI v22.1.3)

Interactive Commands: Commands requiring interactive prompts (like netlify login, netlify init without parameters, interactive dev mode) are not supported by this server. Use a Personal Access Token for authentication and provide required parameters explicitly.
Site Context: Many commands require site context. This server passes the required siteId via the NETLIFY_SITE_ID environment variable when executing these commands. Commands that operate on the current working directory (like status and unlink) may not function as expected when called via the MCP server unless the server directory is properly linked.
Browser-dependent Features: Some commands that require opening browsers or interactive authentication flows may have limited functionality in the MCP server environment.
Real-time Streaming: While log streaming is supported, the output is captured and returned rather than providing a true real-time stream interface.

Development

To modify the server:

Update source code in src/index.ts.
Build with npm run build.
Restart the MCP server in your client application to load changes.
Test your changes.