> This page location: APIs & SDKs > CLI > Organizations and networking > orgs
> 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 orgs` CLI command lists the Neon organizations you belong to and shows one organization's details. Its subcommands also list, inspect, update, and remove members, list and send invitations, and get, set, or remove the organization's monthly spending limit. Use it to look up an org ID before running org-scoped commands, or to manage an organization from the terminal.

# Neon CLI command: orgs

List and inspect organizations, and manage members, invitations, and the spending limit

Last updated: 2026-11-05

The `orgs` command lists the organizations you belong to, shows one organization, and manages its members, invitations, and monthly spending limit. For background, see [Manage organizations](https://neon.com/docs/manage/orgs-manage).

Every subcommand except `list` takes `--org-id`. Without it, the CLI uses the organization in your [`.neon` context file](https://neon.com/docs/cli/link#the-neon-context-file), then the only organization you belong to. Otherwise, it fails and asks you to pass `--org-id`. Changing a member's role, removing a member, and setting or removing the spending limit require an organization Admin.

Subcommands: [get](https://neon.com/docs/cli/orgs#get), [invitations](https://neon.com/docs/cli/orgs#invitations), [list](https://neon.com/docs/cli/orgs#list), [members](https://neon.com/docs/cli/orgs#members), [spending-limit](https://neon.com/docs/cli/orgs#spending-limit)

## neon orgs list

Lists all organizations associated with the authenticated Neon CLI user.

```bash
neon orgs list [options]
```

List your organizations with the default `table` output format. The organization in your [`.neon` context file](https://neon.com/docs/cli/link#the-neon-context-file) is marked `[current]`:

```bash
neon orgs list
```

```text filename="Output"
Organizations
ID                     Name                   Plan
org-xxxxxxxx-xxxxxxxx  [current] Example Org  Launch
org-yyyyyyyy-yyyyyyyy  Another Org            Free
```

List your organizations with `--output json`, which also shows the fields omitted from the `table` output, such as the handle and timestamps. JSON keeps the API's plan ID (for example, `launch`) rather than the display name:

```bash
neon orgs list -o json
```

<details>

<summary>Show output</summary>

```json
[
  {
    "id": "org-xxxxxxxx-xxxxxxxx",
    "name": "Example Org",
    "handle": "example-org-xxxxxxxx",
    "plan": "launch",
    "created_at": "2026-04-22T16:50:41Z",
    "managed_by": "console",
    "updated_at": "2026-06-28T15:38:26Z",
    "require_mfa": false
  }
]
```

</details>

## neon orgs get

Shows an organization's details. Pass the organization ID as an argument or with `--org-id`.

```bash
neon orgs get [id] [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--org-id` | Organization ID. Defaults to the linked organization, or your only one | string | — | No |

```bash
neon orgs get org-xxxxxxxx-xxxxxxxx
```

```text filename="Output"
ID          org-xxxxxxxx-xxxxxxxx
Name        Example Org
Handle      example-org-xxxxxxxx
Plan        Scale
Created At  2026-09-10T16:36:29Z
```

## neon orgs members

Lists, inspects, updates, and removes the members of an organization.

```bash
neon orgs members <sub-command> [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--org-id` | Organization ID. Defaults to the linked organization, or your only one | string | — | No |

Subcommands: [get](https://neon.com/docs/cli/orgs#members-get), [list](https://neon.com/docs/cli/orgs#members-list), [remove](https://neon.com/docs/cli/orgs#members-remove), [update](https://neon.com/docs/cli/orgs#members-update)

### neon orgs members list

Lists members with their email and organization role. Use the `ID` column as the `<member-id>` for the other `members` subcommands. JSON and YAML output keep the API's shape: each item has a `member` object and a `user` object.

```bash
neon orgs members list [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--org-id` | Organization ID. Defaults to the linked organization, or your only one | string | — | No |

```bash
neon orgs members list
```

```text filename="Output"
Members of org-xxxxxxxx-xxxxxxxx
ID                                    Email              Role   Joined At
a1b2c3d4-1111-4a2b-8c3d-0123456789ab  alex@example.com   admin  2026-09-10T16:36:29Z
b2c3d4e5-2222-4b3c-9d4e-123456789abc  dana@example.com   admin  2026-09-25T18:18:32Z
```

### neon orgs members get

Shows one member.

```bash
neon orgs members get <member-id> [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--org-id` | Organization ID. Defaults to the linked organization, or your only one | string | — | No |

```bash
neon orgs members get a1b2c3d4-1111-4a2b-8c3d-0123456789ab
```

### neon orgs members update

Changes a member's organization role. The role sets the member's baseline access across every project in the organization. See [Organization roles](https://neon.com/docs/manage/user-permissions#organization-roles). `--role` accepts `admin`, `editor`, `viewer`, or `collaborator`. `member` is a legacy alias for `editor`. Some roles may not be available for every organization.

```bash
neon orgs members update <member-id> [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--role` | The new organization role Possible values: `admin`, `member`, `editor`, `viewer`, `collaborator` | string | — | Yes |
| `--org-id` | Organization ID. Defaults to the linked organization, or your only one | string | — | No |

```bash
neon orgs members update b2c3d4e5-2222-4b3c-9d4e-123456789abc --role viewer
```

### neon orgs members remove

Removes a member from the organization.

```bash
neon orgs members remove <member-id> [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--org-id` | Organization ID. Defaults to the linked organization, or your only one | string | — | No |

```bash
neon orgs members remove b2c3d4e5-2222-4b3c-9d4e-123456789abc
```

## neon orgs invitations

Lists and sends invitations to join an organization.

```bash
neon orgs invitations <sub-command> [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--org-id` | Organization ID. Defaults to the linked organization, or your only one | string | — | No |

Subcommands: [create](https://neon.com/docs/cli/orgs#invitations-create), [list](https://neon.com/docs/cli/orgs#invitations-list)

### neon orgs invitations list

Lists pending invitations.

```bash
neon orgs invitations list [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--org-id` | Organization ID. Defaults to the linked organization, or your only one | string | — | No |

```bash
neon orgs invitations list
```

```text filename="Output"
Invitations to org-xxxxxxxx-xxxxxxxx
ID                                    Email              Role    Invited At
c3d4e5f6-3333-4c4d-8e5f-23456789abcd  zhang@example.com  viewer  2026-11-05T14:26:14Z
```

### neon orgs invitations create

Invites people by email. Repeat `--email` to invite several people at once. Every invitee gets the same `--role`. Neon emails each one, and anyone who already has a Neon account joins right away.

[Organization API keys](https://neon.com/docs/manage/api-keys#types-of-api-keys) can't send invitations. Use a personal API key instead.

```bash
neon orgs invitations create [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--email` | Email address to invite. Repeat to invite several | array | — | Yes |
| `--role` | The organization role every invitee gets Possible values: `admin`, `member`, `editor`, `viewer`, `collaborator` | string | — | Yes |
| `--org-id` | Organization ID. Defaults to the linked organization, or your only one | string | — | No |

```bash
neon orgs invitations create --email dana@example.com --email zhang@example.com --role editor
```

## neon orgs spending-limit

Gets, sets, and removes the organization's monthly spending limit, which the Console calls the [spending notification](https://neon.com/docs/introduction/spending-notifications) threshold. Available on the Launch and Scale plans.

```bash
neon orgs spending-limit <sub-command> [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--org-id` | Organization ID. Defaults to the linked organization, or your only one | string | — | No |

Subcommands: [delete](https://neon.com/docs/cli/orgs#spending-limit-delete), [get](https://neon.com/docs/cli/orgs#spending-limit-get), [set](https://neon.com/docs/cli/orgs#spending-limit-set)

### neon orgs spending-limit get

Shows the monthly spending limit, or `Not set`. JSON and YAML output keep the API's `spending_limit_cents` field.

```bash
neon orgs spending-limit get [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--org-id` | Organization ID. Defaults to the linked organization, or your only one | string | — | No |

```bash
neon orgs spending-limit get
```

```text filename="Output"
Spending limit for org-xxxxxxxx-xxxxxxxx
Monthly Limit  $500.00
```

### neon orgs spending-limit set

Sets the monthly spending limit in US dollars, with up to two decimal places. Neon emails organization Admins at 80% and 100% of the limit. Reaching the limit doesn't suspend computes.

```bash
neon orgs spending-limit set <usd> [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--org-id` | Organization ID. Defaults to the linked organization, or your only one | string | — | No |

```bash
neon orgs spending-limit set 500
```

### neon orgs spending-limit delete

Removes the monthly spending limit.

```bash
neon orgs spending-limit delete [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--org-id` | Organization ID. Defaults to the linked organization, or your only one | string | — | No |

```bash
neon orgs spending-limit delete
```

```text filename="Output"
Spending limit removed from org-xxxxxxxx-xxxxxxxx
```

---

## Related docs (Organizations and networking)

- [api](https://neon.com/docs/cli/api)
- [ip-allow](https://neon.com/docs/cli/ip-allow)
- [vpc](https://neon.com/docs/cli/vpc)

---

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/orgs"}` to https://feedback.neon.tech/ (no auth required).
