Set up Antigravity for Netlify

Learn how to set up Antigravity for use with Netlify.

This setup guide includes:

• how to share Netlify context with Antigravity
• how to connect Antigravity to the Netlify MCP Server
• common troubleshooting issues and workarounds

Run an agent on Netlify without extra setup?

You can use Agent Runners without local Antigravity setup.

Before you begin

• Antigravity installed.
• Node 22 or higher installed.
• A web project to test deployment with.

You don’t need a Netlify account to try a quick deploy, but you’ll want one to deploy to a site you keep, work as part of a team, set environment variables, or add platform features like Functions or Forms. Antigravity prompts you to log in when it needs to.

Quick setup with netlify.ai

Equip your agent with the latest Netlify context, including agent skills:

fetch https://netlify.ai to help me deploy and build with Netlify using the latest agent skills

You only need to do this once for setup. Fetch https://netlify.ai again when you want to refresh Netlify context or troubleshoot outdated skills.

When Antigravity loads Netlify skills, use Antigravity’s / menu to find and run available skills or agent commands for your project.

Need help authenticating?

For help logging in to Netlify, check out our docs on CLI auth.

Connect to the Netlify MCP Server

Connect to the Netlify MCP Server from Antigravity Customizations:

1. Generate a personal access token in the Netlify UI. Store the token securely.
2. Open Customizations in Antigravity.
3. Select Add MCP.
4. Add a Netlify MCP server that runs npx -y @netlify/mcp.
5. Paste your Netlify personal access token into the Antigravity input for the MCP server.
6. Save the MCP configuration and restart or refresh Antigravity if prompted.

Keep credentials out of your repo

Never commit Netlify CLI config files or personal access tokens to your repo. If your team uses SSO, make sure your token is authorized for the team. Learn more about setting up a Netlify access token.

Learn more about Netlify’s MCP Server.

Next steps

As a next step, consider deploying your project or building custom experiences with Netlify primitives.

Deploying

When you’re ready to deploy a production version or draft version of your site or app, tell Antigravity, which can help you do this. We recommend deciding how you want to deploy first.

Ways to test deploying	Description	CLI command
draft deploy	Safe way to test a deploy without deploying to production	netlify deploy
production deploy	Deploy to the live production version of your site or app, most often used as the first deploy for a new project and less often once the project is live on Netlify	netlify deploy --prod
anonymous deploy	Most often used for temporary projects or for AI agents testing flows, this command can generate a temporary live URL. You have one hour to claim ownership of the deployed project by logging in or creating a Netlify account. After one hour, unclaimed projects are removed.	netlify deploy --allow-anonymous

Learn more about deploy types and the CLI:

• Deploy types
• Get started with the CLI

Building with primitives

After confirming you can deploy successfully, consider building custom experiences with Netlify’s agent skills.

You can try some of these prompt ideas based on the capabilities of Netlify’s primitives:

• “Add a new contact page to my site using Netlify Forms with spam protection”
• “Convert this Express endpoint into a Netlify Function”
• “Implement an Edge Function that geolocates users and rewrites to localized content”
• “Check my netlify.toml configuration for issues”

Troubleshooting Antigravity setup for Netlify

Get help with some common troubleshooting issues.

Netlify MCP server cannot authenticate

If the Netlify MCP server cannot authenticate through Antigravity, confirm that you pasted the correct personal access token into the Antigravity input for the MCP server.

If your team uses SSO, make sure you allow the token to access your SAML-based Netlify team. If the token is expired or unavailable, create a new personal access token in the Netlify UI and update the MCP server input in Antigravity.

Authentication issues

If you’re having issues logging in to Netlify, consider whether your company has enabled Netlify SSO and whether you need to use a different work login or personal user ID or email to log in.

For more help authenticating to Netlify, check out our docs on CLI auth.

You can prompt Antigravity to help you log in, or use the CLI command netlify login.

If your project doesn’t contain sensitive information, you can try running an anonymous deploy using the Netlify CLI to get a test deploy that will expire within an hour unless it is claimed.

Deploy issues

You can try running an anonymous deploy to isolate some deploy issues, such as auth issues. We only recommend this if your project doesn’t contain sensitive information, since the anonymous deploy generates a temporary URL that expires within an hour unless it’s claimed.

Netlify CLI issues

To check that Netlify CLI is installed:

netlify status

To test your connection is to the right existing Netlify account:

netlify login

To directly install latest version of the Netlify CLI, run this command in your terminal:

npm install -g netlify-cli

Then confirm your setup with netlify --help or just netlify.

Netlify skills don’t install or seem outdated

Ask Antigravity to fetch https://netlify.ai again for the latest Netlify context. You can also reference Netlify’s agent skills repository directly if you need Antigravity to inspect the source.

If you confirm you have the latest agent skill, you can ask Antigravity to use it directly in a session using /<skill-name> or Antigravity’s / menu.

Node issues

For the best experience, we recommend using Node 22 or higher.

In your terminal, run node --version to check your current version.

If you have a Node version manager like nvm, you can run nvm install 22 to install Node 22 and nvm use 22 to use it.