XO Docs

Vercel

Connect Vercel so your agent can read deployments and project metadata.

Connect a Vercel account to your XO project so your agent can read deployments and project metadata. Vercel uses OAuth — same callback flow as Google Drive and OneDrive.

What You'll Need

  • An XO project that has finished provisioning
  • A Vercel account with access to the team and projects you want your agent to read

Connect Vercel

Open Setup → Data

From your project page, open the Setup tab and select Data.

Setup → Data

Select an Authentication Method

On the Vercel row, pick how you want to authenticate:

  • OAuth (used in this guide) — click Open Vercel and sign in via Vercel's web flow.
  • Access Token — paste a token you create from your Vercel account settings. Use this if you want scoped access or if your workspace blocks OAuth.

Select OAuth and click Open Vercel

The remaining steps follow the OAuth flow. If you picked Access Token, paste the token, click Finish, and you're done.

Sign In with Google

Click Continue with Google and pick the Google account tied to your Vercel login.

Click Continue with Google

Select your Google account

Select Vercel Account or Team

Pick the Vercel account or team whose deployments you want your agent to read.

Select the Vercel account or team

Allow Authorization

Review the requested scopes and click Allow to grant XO access.

Click Allow

Paste the Callback URL

After authorizing, Vercel redirects to a 127.0.0.1/callback?...&code=... URL. Your browser will show "This site can't be reached" — that's expected. The URL itself contains the auth code.

Copy the full URL from your browser's address bar.

Copy the callback URL from the address bar

Switch back to the XO tab, click the Callback URL field, and paste with Cmd + V (or Ctrl + V on Windows/Linux).

Click the Callback URL field

Paste the callback URL

Don't worry about the connection error — XO doesn't run a local callback server. The auth code lives in the URL, not on the page.

Click Finish.

Click Finish

Your Vercel account is now connected. Your agent can read deployments and project metadata on subsequent runs.

On this page