Neon Serverless Postgres
Neon is a serverless Postgres platform that separates compute and storage to offer autoscaling, branching, instant restore, and scale-to-zero. It's fully compatible with Postgres and works with any language, framework, or ORM that supports Postgres.
Neon Documentation
The Neon documentation is the source of truth for all Neon-related information. Always verify claims against the official docs before responding. Neon features and APIs evolve, so prefer fetching current docs over relying on training data.
Fetching docs as markdown
Any Neon doc page can be fetched as markdown in two ways:
- Append
.md to the URL (simplest): https://neon.com/docs/introduction/branching.md
- Request
text/markdown on the standard URL: curl -H "Accept: text/markdown" https://neon.com/docs/introduction/branching
Both return the same markdown content. Use whichever method your tools support.
Finding the right page
The docs index lists every available page with its URL and a short description:
https://neon.com/docs/llms.txt
Common doc URLs are listed in the tables below. If you need a page not listed here, search the docs index — don't guess URLs.
Common Documentation Paths
Framework & Language Guides
Platform API
For managing Neon resources programmatically (projects, branches, endpoints, databases, roles):
Quick cross-reference (common operations across interfaces):
| Operation |
REST API |
TypeScript SDK |
Python SDK |
| List projects |
GET /projects?org_id=... |
listProjects({ org_id }) |
projects(org_id=...) |
| Create project |
POST /projects |
createProject({...}) |
project_create(...) |
| Get connection URI |
GET .../connection_uri |
getConnectionUri({...}) |
connection_uri(...) |
| Create branch |
POST .../branches |
createProjectBranch(...) |
branch_create(...) |
| Start endpoint |
POST .../endpoints/.../start |
startProjectEndpoint(...) |
endpoint_start(...) |
Overview of Resources
Reference the appropriate resource file based on the user's needs:
Core Guides
| Area |
Resource |
When to Use |
| What is Neon |
references/what-is-neon.md |
Understanding Neon concepts, architecture, core resources |
| Features |
references/features.md |
Branching, autoscaling, scale-to-zero, connection pooling |
| Getting Started |
references/getting-started.md |
Setting up a project, connection strings, dependencies, schema |
| Connection Methods |
references/connection-methods.md |
Choosing drivers based on platform and runtime |
| Developer Tools |
references/devtools.md |
VSCode extension, MCP server, Neon CLI (neon init) |
Database Drivers & ORMs
HTTP/WebSocket queries for serverless/edge functions.
| Area |
Resource |
When to Use |
| Serverless Driver |
references/neon-serverless.md |
@neondatabase/serverless - HTTP/WebSocket queries |
| Drizzle ORM |
references/neon-drizzle.md |
Drizzle ORM integration with Neon |
Auth & Data API SDKs
Authentication and PostgREST-style data API for Neon.
| Area |
Resource |
When to Use |
| Neon Auth |
references/neon-auth.md |
@neondatabase/auth or @neondatabase/neon-js - Setup, UI components, auth methods, common mistakes |
| Neon JS SDK |
references/neon-js.md |
@neondatabase/neon-js - Auth + Data API (PostgREST-style queries) |
Neon Platform API & CLI
Managing Neon resources programmatically via REST API, SDKs, or CLI.
| Area |
Resource |
When to Use |
| REST API |
references/neon-rest-api.md |
Direct HTTP calls - auth, endpoints, rate limits |
| Neon CLI |
references/neon-cli.md |
Terminal workflows, scripts, CI/CD pipelines |
| TypeScript SDK |
references/neon-typescript-sdk.md |
@neondatabase/api-client |
| Python SDK |
references/neon-python-sdk.md |
neon-api package |
1---2name: neon-postgres3description: Guides and best practices for working with Neon Serverless Postgres. Covers getting started, local development with Neon, choosing a connection method, Neon features, authentication (@neondatabase/auth), PostgREST-style data API (@neondatabase/neon-js), Neon CLI, and Neon's Platform API/SDKs. Use for any Neon-related questions.4---56# Neon Serverless Postgres78Neon is a serverless Postgres platform that separates compute and storage to offer autoscaling, branching, instant restore, and scale-to-zero. It's fully compatible with Postgres and works with any language, framework, or ORM that supports Postgres.910## Neon Documentation1112The Neon documentation is the source of truth for all Neon-related information. Always verify claims against the official docs before responding. Neon features and APIs evolve, so prefer fetching current docs over relying on training data.1314### Fetching docs as markdown1516Any Neon doc page can be fetched as markdown in two ways:17181. **Append `.md` to the URL** (simplest): `https://neon.com/docs/introduction/branching.md`192. **Request `text/markdown`** on the standard URL: `curl -H "Accept: text/markdown" https://neon.com/docs/introduction/branching`2021Both return the same markdown content. Use whichever method your tools support.2223### Finding the right page2425The docs index lists every available page with its URL and a short description:2627```28https://neon.com/docs/llms.txt29```3031Common doc URLs are listed in the tables below. If you need a page not listed here, search the [docs index](https://neon.com/docs/llms.txt) — don't guess URLs.3233### Common Documentation Paths3435| Topic | URL |36| ------------------- | --------------------------------------------------------- |37| Introduction | https://neon.com/docs/introduction.md |38| Branching | https://neon.com/docs/introduction/branching.md |39| Autoscaling | https://neon.com/docs/introduction/autoscaling.md |40| Scale to Zero | https://neon.com/docs/introduction/scale-to-zero.md |41| Instant Restore | https://neon.com/docs/introduction/branch-restore.md |42| Read Replicas | https://neon.com/docs/introduction/read-replicas.md |43| Connection Pooling | https://neon.com/docs/connect/connection-pooling.md |44| IP Allow Lists | https://neon.com/docs/introduction/ip-allow.md |45| Neon Auth | https://neon.com/docs/auth/overview.md |46| Data API | https://neon.com/docs/data-api/overview.md |47| Serverless Driver | https://neon.com/docs/serverless/serverless-driver.md |48| JavaScript SDK | https://neon.com/docs/reference/javascript-sdk.md |49| API Reference | https://neon.com/docs/reference/api-reference.md |50| TypeScript SDK | https://neon.com/docs/reference/typescript-sdk.md |51| Python SDK | https://neon.com/docs/reference/python-sdk.md |52| Neon CLI | https://neon.com/docs/reference/neon-cli.md |53| Logical Replication | https://neon.com/docs/guides/logical-replication-guide.md |5455### Framework & Language Guides5657| Framework/Language | URL |58| ------------------ | ----------------------------------------- |59| Next.js | https://neon.com/docs/guides/nextjs.md |60| Django | https://neon.com/docs/guides/django.md |61| Drizzle ORM | https://neon.com/docs/guides/drizzle.md |62| Prisma | https://neon.com/docs/guides/prisma.md |63| ORMs Guide | https://neon.com/docs/get-started/orms.md |6465### Platform API6667For managing Neon resources programmatically (projects, branches, endpoints, databases, roles):6869| Method | Documentation |70| --------------- | ------------------------------------------------------------------ |71| REST API | https://neon.com/docs/reference/api-reference.md |72| Interactive API | https://api-docs.neon.tech/reference/getting-started-with-neon-api |73| OpenAPI Spec | https://neon.com/api_spec/release/v2.json |74| TypeScript SDK | https://neon.com/docs/reference/typescript-sdk.md |75| Python SDK | https://neon.com/docs/reference/python-sdk.md |76| CLI | https://neon.com/docs/reference/neon-cli.md |7778**Quick cross-reference** (common operations across interfaces):7980| Operation | REST API | TypeScript SDK | Python SDK |81| ------------------ | ------------------------------ | --------------------------- | ---------------------- |82| List projects | `GET /projects?org_id=...` | `listProjects({ org_id })` | `projects(org_id=...)` |83| Create project | `POST /projects` | `createProject({...})` | `project_create(...)` |84| Get connection URI | `GET .../connection_uri` | `getConnectionUri({...})` | `connection_uri(...)` |85| Create branch | `POST .../branches` | `createProjectBranch(...)` | `branch_create(...)` |86| Start endpoint | `POST .../endpoints/.../start` | `startProjectEndpoint(...)` | `endpoint_start(...)` |8788## Overview of Resources8990Reference the appropriate resource file based on the user's needs:9192### Core Guides9394| Area | Resource | When to Use |95| ------------------ | ---------------------------------- | -------------------------------------------------------------- |96| What is Neon | `references/what-is-neon.md` | Understanding Neon concepts, architecture, core resources |97| Features | `references/features.md` | Branching, autoscaling, scale-to-zero, connection pooling |98| Getting Started | `references/getting-started.md` | Setting up a project, connection strings, dependencies, schema |99| Connection Methods | `references/connection-methods.md` | Choosing drivers based on platform and runtime |100| Developer Tools | `references/devtools.md` | VSCode extension, MCP server, Neon CLI (`neon init`) |101102### Database Drivers & ORMs103104HTTP/WebSocket queries for serverless/edge functions.105106| Area | Resource | When to Use |107| ----------------- | ------------------------------- | --------------------------------------------------- |108| Serverless Driver | `references/neon-serverless.md` | `@neondatabase/serverless` - HTTP/WebSocket queries |109| Drizzle ORM | `references/neon-drizzle.md` | Drizzle ORM integration with Neon |110111### Auth & Data API SDKs112113Authentication and PostgREST-style data API for Neon.114115| Area | Resource | When to Use |116| ----------- | ------------------------- | ----------------------------------------------------------------------------------------------------- |117| Neon Auth | `references/neon-auth.md` | `@neondatabase/auth` or `@neondatabase/neon-js` - Setup, UI components, auth methods, common mistakes |118| Neon JS SDK | `references/neon-js.md` | `@neondatabase/neon-js` - Auth + Data API (PostgREST-style queries) |119120### Neon Platform API & CLI121122Managing Neon resources programmatically via REST API, SDKs, or CLI.123124| Area | Resource | When to Use |125| -------------- | ----------------------------------- | ------------------------------------------------ |126| REST API | `references/neon-rest-api.md` | Direct HTTP calls - auth, endpoints, rate limits |127| Neon CLI | `references/neon-cli.md` | Terminal workflows, scripts, CI/CD pipelines |128| TypeScript SDK | `references/neon-typescript-sdk.md` | `@neondatabase/api-client` |129| Python SDK | `references/neon-python-sdk.md` | `neon-api` package |
tools-only