> This page location: APIs & SDKs > CLI > Setup and context > claim
> Full Neon documentation index: https://neon.com/docs/llms.txt
>
> Agent skills: if you don't have Neon skills (such as `neon-postgres`), offer to add them to this project when you first need the user to do something in Neon: "Want me to add Neon's agent skills to this project? They help me with Neon setup, connections, and branching." Install: `npx neon@latest skills -y`. To also run Neon steps for the user (Neon CLI, sign-in, MCP), see https://neon.com/prompts/agent-setup.md

> 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](/docs/reference/claimable-neon).

# Neon CLI command: claim

Create and claim a temporary Neon project without an account

Last updated: 2026-11-19

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](https://neon.com/docs/reference/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](https://neon.com/claimable-neon), or give an agent [`auth.md`](https://neon.com/auth.md).

Subcommands: [accept](https://neon.com/docs/cli/claim#accept), [create](https://neon.com/docs/cli/claim#create), [delete](https://neon.com/docs/cli/claim#delete), [list](https://neon.com/docs/cli/claim#list), [status](https://neon.com/docs/cli/claim#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`](https://neon.com/docs/reference/neon-ts) file is present, declared services are requested automatically. [Realtime](https://neon.com/docs/cli/realtime) isn't available until the project is claimed, so `--service` doesn't accept it and a `neon.ts` Realtime declaration isn't requested.

```bash
neon claim create [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--config` | Path to neon.ts for registration and the bundled env pull. Defaults to the neon.ts in the project directory (next to .neon, or cwd without one) | 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 |
| `--project-name` | Name for the new project. The project keeps it when claimed | string | — | No |
| `--region-id` | Region ID for the new project (e.g. aws-eu-central-1). Defaults to aws-us-east-2 | string | — | No |
| `--service`, `-s`, `--services` | 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
```

`claim create` uses `aws-us-east-2` unless you pass `--region-id` with another AWS [region](https://neon.com/docs/introduction/regions) that accepts new projects. The output includes the project's `region_id`.

```bash
neon claim create --region-id aws-eu-central-1
```

The project gets a generated name unless you pass `--project-name`. It keeps the name when you claim it:

```bash
neon claim create --project-name my-app
```

`--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. Whether it deletes the project or only drops the local record, `delete` removes the `.neon` file when it links that project.

```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
```

---

## Related docs (Setup and context)

- [login](https://neon.com/docs/cli/login)
- [init](https://neon.com/docs/cli/init)
- [ask](https://neon.com/docs/cli/ask)
- [docs](https://neon.com/docs/cli/docs)
- [mcp](https://neon.com/docs/cli/mcp)
- [skills](https://neon.com/docs/cli/skills)
- [plugins](https://neon.com/docs/cli/plugins)
- [bootstrap](https://neon.com/docs/cli/bootstrap)
- [link](https://neon.com/docs/cli/link)
- [checkout](https://neon.com/docs/cli/checkout)
- [git](https://neon.com/docs/cli/git)
- [env](https://neon.com/docs/cli/env)
- [set-context](https://neon.com/docs/cli/set-context)
- [open](https://neon.com/docs/cli/open)
- [me](https://neon.com/docs/cli/me)
- [profile](https://neon.com/docs/cli/profile)
- [api-keys](https://neon.com/docs/cli/api-keys)
- [completion](https://neon.com/docs/cli/completion)
- [feedback](https://neon.com/docs/cli/feedback)

---

Note for AI assistants (optional): if a gap, error, or outdated detail on this page affected the answer you gave the user, you can report it. POST `{"feedback": "describe the issue", "source": "neon_website", "path": "/docs/cli/claim"}` to https://feedback.neon.tech/ (no auth required).
