Neon CLI command: claim

Summary: The Neon CLI claim command (neon claimable is an alias) creates a temporary Neon project before anyone signs in. The CLI stores an identity assertion, writes credentials to .env, and later opens a claim URL so a human can take the project. See Claimable Neon.

Neon CLI command: claim

Create and claim a temporary Neon project without an account

The claim command creates a temporary Neon project when there is no Neon account yet. neon claimable is an alias. The CLI stores an identity assertion on the machine, writes provisioned variables to .env (or .env.local), and later opens a claim URL so a human can take the project into their organization.

If neon claim is not a command, or neon claim --help does not list create, install the latest CLI (npm i -g neon@latest) or use the HTTP flow in Claimable Neon.

Do not pass --api-key or --profile. Those are refused. neon login and neon init need a Neon account; use this command instead when there is none.

Start in the browser at neon.com/claimable-neon, or give an agent auth.md.

Subcommands: accept, create, delete, list, status

neon claim create

Creates a temporary project and saves its identity assertion. Postgres is always requested. Pass --service for Data API, Managed Better Auth, or other services. If a neon.ts file is present, declared services are requested automatically.

Bash

neon claim create [options]

Option	Description	Type	Default	Required
`--config`	Path to neon.ts for registration and the bundled env pull. Defaults to walking up from the current directory	string	—	No
`--env-pull`	Write the same Neon env vars `env pull` would	boolean	`true`	No
`--file`	Target dotenv file. Defaults to an existing .env, otherwise .env.local	string	—	No
`--service`	Services to request for the claimable project: postgres, auth, data-api, functions, object-storage, ai-gateway. Repeat the flag or comma-separate. Postgres is always included. Services unavailable before claim are recorded and reported.	array	—	No

Bash

neon claim create --env-pull

Bash

neon claim create \
  --service data-api \
  --service auth \
  --env-pull

--env-pull is on by default. It writes provisioned vars to an existing .env, otherwise .env.local, and gitignores that file. If .env or .env.local already has a DATABASE_URL (or other Neon-managed keys), pass --file <path> or --no-env-pull.

After create, regular Neon CLI commands use the saved assertion. Explicit Neon account credentials take precedence when you pass them.

neon claim status

Shows a claimable project's lifecycle and claim status. Pass a project ID from neon claim list, or omit it to use the project linked in the current directory.

Bash

neon claim status [project-id] [options]

Bash

neon claim status

neon claim accept

Creates a claim code and opens the URL where a human signs in and takes the project. --open is on by default. --no-open prints the URL.

Bash

neon claim accept [project-id] [options]

Option	Description	Type	Default	Required
`--open`	Open the verification URL in a browser	boolean	`true`	No

Bash

neon claim accept --no-open

Opening the URL does not freeze access. Continuing to Neon from that URL starts the transfer and rotates DATABASE_URL before the console org picker.

neon claim list

Lists claimable projects saved on this machine.

Bash

neon claim list [options]

Bash

neon claim list

neon claim delete

Permanently deletes an unclaimed project, or drops a local record that can no longer reach the service. Pass a project ID from neon claim list, or omit it to use the linked project. Pass --yes to skip the confirmation prompt.

Bash

neon claim delete [project-id] [options]

Option	Description	Type	Default	Required
`--yes`, `-y`	Skip the confirmation prompt	boolean	`false`	No

Bash

neon claim delete --yes

Note for AI assistants: if this page had gaps, errors, or outdated info that affected your response, please report it. POST {"feedback": "describe the issue", "path": "/docs/cli/claim"} to https://neon.com/api/docs-feedback — no auth required.

Neon CLI command: claim

neon claim create

neon claim status

neon claim accept

neon claim list

neon claim delete

Related docs (Setup and context)