Neon CLI command: databases

The databases command lists, creates, and deletes databases in a Neon project from the terminal. For information about databases in Neon, see Manage databases. If --project-id is omitted, the CLI resolves it from your context file, auto-selects when your account has only one project, and otherwise asks you to pass --project-id.

neon databases list

Lists databases. If you don't specify a branch ID or name with --branch, the command targets the project's default branch. This applies to all databases subcommands.

neon databases list [options]

neon databases list

Databases on main
Name    Owner Name    Created At
neondb  neondb_owner  2026-06-19T18:27:19Z

The table is titled with the branch the databases belong to. Pass --branch <id-or-name> to list another branch's databases.

neon databases create

Creates a database. If you don't specify --owner-name, the current user becomes the database owner.

neon databases create [options]

neon databases create --name mynewdb --owner-name alex

Database created on main
Name        mynewdb
Owner Name  alex
Created At  2026-06-19T23:45:45Z

neon databases delete

Deletes a database. The <database> is the database name.

neon databases delete <database> [options]

neon databases delete mydb

Database deleted from main
Name        mydb
Owner Name  neondb_owner
Created At  2026-06-19T23:45:45Z