Skip to content
Netlify Docs
For the complete Netlify documentation index, see llms.txt. Markdown versions of any documentation page are available by appending .md to its URL.

The new Netlify experience is here. Learn more or join the waitlist.

Agent setup overview

Learn how to set up any agent with Netlify, including custom agents, in a few minutes. For setup steps written for your specific agent, check out the guides for specific agents below.

Run this in your project folder:

npx netlify@latest init

It signs you in, installs Netlify’s agent skills, adds the Netlify MCP server for the agents it finds, and links the folder to a Netlify project. Then open your agent in the same folder and ask your agent for a draft or production deploy.

Connect to the Netlify MCP server to equip your agent with the best of Netlify expertise and the Netlify CLI.

Netlify offers an MCP server, which you can connect to through a connector, plugin, or your agent.

To start connecting to Netlify’s remote MCP server by running this command and following the prompts to select the agents you want to configure:

npx -y add-mcp https://mcp.netlify.com/mcp

To use your agent’s own official setup, check out the guides for specific agents below.

The following editors allow one-click install of our MCP with the following links

Install MCP Server on Cursor

Add MCP Server netlify to LM Studio

Install on VS Code

Install on VS Code Insiders Edition

Our recommendation is to use the remote MCP server to have the most up-to-date version of the MCP capabilities. However, some developers are required to use local MCP servers in their environments. You can use the following command to install Netlify's local MCP:

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

Each guide covers the setup path for one agent:

  • Claude: Claude.ai and Claude Desktop, through the Netlify connector
  • Claude Code: Claude Code in your terminal
  • ChatGPT: ChatGPT, through the Netlify app
  • Codex: Codex in your terminal
  • Grok: Grok, through the Netlify connector
  • Antigravity: Antigravity, through the Netlify plugin
  • Antigravity CLI: Antigravity CLI in your terminal

To help your agent build with best practices, check out our agent skills for building and deploying on Netlify.

The fetch https://netlify.ai message and npx netlify@latest init both install Netlify’s agent skills for you. You can also share a skill directly with your agent or have all skills installed in your local project files or repository. Some agents also support invoking a specific skill by name in a command, such as Claude Code with /<skill-name>.

To install only Netlify’s agent skills, run this in your terminal or agent chat:

npx skills add netlify/context-and-tools --skill '*' --yes

Learn more about agent skills for building and deploying on Netlify in our official agent skills repository.

Here are some highlights of agent skills for building and deploying on Netlify. Note that if you are using Agent Runners, you don't need to invoke agent skills as they are applied automatically for you.

Skill Feature Support Description
netlify-functions Netlify Functions Modern syntax, routing, Background Functions, Scheduled Functions, and streaming
netlify-edge-functions Edge Functions Deno runtime, middleware patterns, geolocation, and request manipulation
netlify-blobs Netlify Blobs Key-value and binary object storage with zero configuration
netlify-db Netlify Database Managed Postgres, Drizzle ORM integration, and migrations
netlify-image-cdn Image CDN On-the-fly image transformation and optimization
netlify-forms Netlify Forms HTML form handling, AJAX submissions, and spam filtering
netlify-config File-based configuration netlify.toml configuration, including redirects, headers, build settings, and deploy contexts
netlify-cli-and-deploy Netlify CLI Commands, Git and manual deploys, and environment variables
netlify-deploy Create deploys Authentication, site linking, Deploy Previews, and production deploys
netlify-frameworks Framework adapters Vite, Astro, TanStack Start, and Next.js on Netlify
netlify-caching Caching CDN cache control, cache tags, purge, and stale-while-revalidate
netlify-ai-gateway AI Gateway Proxy for OpenAI, Anthropic, and Google AI SDKs

Netlify publishes a JSON schema for netlify.toml that lists the supported properties and the values they accept. Point your agent to it when it writes or edits your Netlify configuration, so it uses properties that exist instead of guessing:

check netlify.toml against the schema at https://open-api.netlify.com/netlify.schema.json, and add "$schema" = "https://open-api.netlify.com/netlify.schema.json" at the top of the file

With the $schema key in the file, editors that support the schema also flag invalid values as you or your agent make changes. Learn more about schema validation.