Neon serverless Postgres — manage projects, branches, databases, roles, endpoints, and compute via the Neon API. Create database branches for development, manage connection endpoints, scale compute, and monitor usage. Built for AI agents — Python stdlib only, zero dependencies. Use for serverless Postgres, database branching, database management, development workflows, and cloud database automation.
Neon serverless Postgres — manage projects, branches, databases, roles, endpoints, and compute via the Neon API.
| Variable | Required | Description |
|---|
NEON_API_KEY | ✅ | API key/token for Neon |
# List projects
python3 {baseDir}/scripts/neon.py projects --limit 20
# Get project details
python3 {baseDir}/scripts/neon.py project-get proj-abc123
# Create a project
python3 {baseDir}/scripts/neon.py project-create '{"project":{"name":"my-app","region_id":"aws-us-east-1"}}'
# Delete a project
python3 {baseDir}/scripts/neon.py project-delete proj-abc123
projectsList projects.
python3 {baseDir}/scripts/neon.py projects --limit 20
project-getGet project details.
python3 {baseDir}/scripts/neon.py project-get proj-abc123
project-createCreate a project.
python3 {baseDir}/scripts/neon.py project-create '{"project":{"name":"my-app","region_id":"aws-us-east-1"}}'
project-deleteDelete a project.
python3 {baseDir}/scripts/neon.py project-delete proj-abc123
branchesList branches.
python3 {baseDir}/scripts/neon.py branches --project proj-abc123
branch-createCreate a branch.
python3 {baseDir}/scripts/neon.py branch-create --project proj-abc123 '{"branch":{"name":"dev","parent_id":"br-main"}}'
branch-deleteDelete a branch.
python3 {baseDir}/scripts/neon.py branch-delete --project proj-abc123 br-dev
branch-restoreRestore branch to point in time.
python3 {baseDir}/scripts/neon.py branch-restore --project proj-abc123 br-main --timestamp '2026-02-01T00:00:00Z'
databasesList databases.
python3 {baseDir}/scripts/neon.py databases --project proj-abc123 --branch br-main
database-createCreate database.
python3 {baseDir}/scripts/neon.py database-create --project proj-abc123 --branch br-main '{"database":{"name":"mydb","owner_name":"neondb_owner"}}'
rolesList roles.
python3 {baseDir}/scripts/neon.py roles --project proj-abc123 --branch br-main
endpointsList endpoints.
python3 {baseDir}/scripts/neon.py endpoints --project proj-abc123
connection-stringGet connection string.
python3 {baseDir}/scripts/neon.py connection-string --project proj-abc123 --branch br-main --database mydb
consumptionGet consumption metrics.
python3 {baseDir}/scripts/neon.py consumption --from 2026-01-01 --to 2026-02-01
operationsList operations.
python3 {baseDir}/scripts/neon.py operations --project proj-abc123 --limit 10
All commands output JSON by default. Add --human for readable formatted output.
# JSON (default, for programmatic use)
python3 {baseDir}/scripts/neon.py projects --limit 5
# Human-readable
python3 {baseDir}/scripts/neon.py projects --limit 5 --human
| Script | Description |
|---|---|
{baseDir}/scripts/neon.py | Main CLI — all Neon operations |
This skill never stores data locally. All requests go directly to the Neon API and results are returned to stdout. Your data stays on Neon servers.
Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.
📅 Need help setting up OpenClaw for your business? Book a free consultation