How to Use Neon Serverless Postgres MCP

Manage Neon serverless Postgres branches, run queries, and scale databases from Claude Code — ideal for branching-based development workflows.

neonpostgresserverlessdatabaseclaude-code

What is the Neon MCP?

Neon is a serverless Postgres platform with built-in branching — each database branch is an isolated, instant copy of your data. The Neon MCP brings the Neon API and SQL execution capabilities into Claude Code, making it easy to create feature branches, run migrations safely, and manage your serverless Postgres fleet without leaving your editor.

Installation

mcpizy install neon

Generate a Neon API key from your Neon console under Account Settings > API Keys. Provide the key during MCPizy setup.

Key Capabilities

Create and manage database branches — spin up an instant copy of your database for a feature or PR.
Execute SQL queries — run queries against any branch using Neon's HTTP-based SQL API.
List projects and endpoints — discover your Neon projects and their connection strings.
Scale compute — adjust compute size or enable auto-suspend for cost optimization.
Reset branches — restore a branch to match its parent after testing destructive changes.

Example Usage

Create a database branch for a new feature before running a risky migration:

// Claude will:
// 1. Create a branch "feature/add-audit-logs" from main
// 2. Apply the migration on that branch
// 3. Run integration tests against the branch connection string
// 4. Merge or discard the branch based on results

Tips and Best Practices

Use one database branch per PR — Neon branches are free and instant, so there is no cost to this workflow.
Always run migrations on a branch first, never directly on the main branch in production.
Combine with Supabase MCP if you are migrating from Supabase to Neon or running both in parallel.
Enable auto-suspend on development branches to minimize compute costs when not actively querying.

View on MCPizy Marketplace

Found this useful? Share it.

MCP Servers Mentioned

Neon Supabase Mcp Postgres

All Articles Browse Marketplace

What is the Neon MCP?

Key Capabilities

Create and manage database branches — spin up an instant copy of your database for a feature or PR.

Execute SQL queries — run queries against any branch using Neon's HTTP-based SQL API.

List projects and endpoints — discover your Neon projects and their connection strings.

Scale compute — adjust compute size or enable auto-suspend for cost optimization.

Reset branches — restore a branch to match its parent after testing destructive changes.

Example Usage

Create a database branch for a new feature before running a risky migration:

// Claude will: // 1. Create a branch "feature/add-audit-logs" from main // 2. Apply the migration on that branch // 3. Run integration tests against the branch connection string // 4. Merge or discard the branch based on results

Tips and Best Practices

Use one database branch per PR — Neon branches are free and instant, so there is no cost to this workflow.

Always run migrations on a branch first, never directly on the main branch in production.

Combine with Supabase MCP if you are migrating from Supabase to Neon or running both in parallel.

Enable auto-suspend on development branches to minimize compute costs when not actively querying.