Neon MCP

Official Neon serverless Postgres MCP server — manage branches, run queries, and handle migrations through AI.

TRUSTED · Official

// Add to your client

{
  "mcpServers": {
    "neon": {
      "command": "npx",
      "args": ["-y", "@neondatabase/mcp-server-neon", "start", "<your-neon-api-key>"]
    }
  }
}

{
  "mcpServers": {
    "neon": {
      "command": "npx",
      "args": ["-y", "@neondatabase/mcp-server-neon", "start", "<your-neon-api-key>"]
    }
  }
}

claude mcp add neon -- npx -y @neondatabase/mcp-server-neon start <your-neon-api-key>

Paste into your client's MCP configuration file.

// Try it now

"List all my Neon projects and their current branches"

! Neon API keys can be scoped to specific projects — use the narrowest scope you can
! Branches share storage but have their own compute — spinning up too many can incur cost
! Deleting a branch is instant and irreversible — there's no recycle bin

Setup

Easy Setup

API key or simple config

Token usage

Light usage

// When to use

You use Neon for serverless Postgres and want AI help managing it
You need to create ephemeral branches for testing migrations
You want to query databases across branches conversationally
You're setting up new projects and want AI to scaffold them

// When NOT to use

You self-host Postgres (use postgres-mcp instead)
You use Supabase, PlanetScale, or another managed Postgres
You need features not exposed by Neon's API (like custom extensions)

// Usage Scenarios

Branch-Based Testing

Create a database branch from production to safely test migrations.

Example prompt

"Create a branch of my production database called 'test-migration' and run the new migration there"

Multi-Branch Queries

Compare data or schemas across branches to verify changes.

Example prompt

"Compare the user table schema between the main branch and the staging branch"

Project Scaffolding

Create a new Neon project with the right settings for a new app.

Example prompt

"Create a new Neon project in us-east-2 and give me the connection string"

// About

Plain English

Imagine telling your AI: 'Create a new branch of my production database for testing' or 'Run this migration on the staging branch' — and it manages Neon for you. This server connects your AI to Neon's serverless Postgres so it can manage projects, create branches, run queries, and handle migrations through conversation.

The official Neon MCP server gives AI assistants full control over Neon serverless Postgres databases. Create and manage database branches, run queries, handle migrations, inspect schemas, and monitor usage — all through natural language.

Maintained by Neon with deep integration into Neon's branching workflow. Ideal for teams using Neon's serverless Postgres.

GitHub 2.1kUpdated Feb 13, 2025MIT

View on GitHub Official Site