Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.

Setup

  1. Sign in to Netlify: Go to https://app.netlify.com and sign in (the free Starter plan with one deployed site is sufficient for testing).
  2. Create a personal access token: Open User settings > Applications > Personal access tokens (https://app.netlify.com/user/applications#personal-access-tokens), select New access token, name it, and set an expiration.
  3. Set the environment variable: Add the token to your .env as NETLIFY_AUTH_TOKEN=…
  4. Verify access: Run List Sites. Site IDs accept either the UUID or the site’s domain (e.g. my-site.netlify.app).

Provider notes

  • Tokens are sent as ‘Authorization: Bearer <token>’
  • List endpoints paginate with page/per_page (max 100) and return next/prev links in the Link response header
  • Triggering builds is rate limited (3 per minute, 100 per day)
Provider API reference.

Tools

Verify the connection

Call a read tool such as netlify__list_sites with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.