Neon MCP Server

Official

Serverless Postgres with database branching — point your assistant at Neon and let it work on disposable copies.

Local + remotestdiossestreamable-httpTypeScriptMIT★ 600

What is the Neon MCP Server?

Neon’s MCP server connects an authorized assistant to documented project, branch and database workflows.

Use a branch for a reviewable experiment

Specify the project and branch before investigating a schema change. For a migration proposal, read the current schema, show the intended SQL and choose a development branch for the first execution. Keep acceptance checks with the proposal.

Connection and scope

Follow Neon’s documented local or hosted connection and its authentication flow. Verify the project and branch returned by the first read. OAuth identity, database credentials and branch selection describe different parts of the connection.

Review the resulting workflow

Inspect the schema and query result after a change, then run the application path that uses it. A migration that executes without an SQL error can still break application assumptions. Confirm the branch before promoting any tested change.

Publisher documentation

Source 1

What you can do with it

Safe AI-driven migrations

Schema changes stage on a temp branch and apply only after you confirm — a review gate built into the workflow.

Instant dev databases

Spin up a branch with production-shaped data for each experiment, then delete it.

Prototype provisioning

Let the assistant create the project, schema and connection string for a new app in one go.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_projects / create_projectEnumerate and provision Neon projects
run_sqlExecute SQL against a chosen project and branch
create_branch / delete_branchCopy-on-write database branches in seconds
prepare_database_migrationStage a schema change on a temporary branch
complete_database_migrationApply a staged migration after confirmation
get_connection_stringFetch connection details for any branch
describe_table_schemaInspect table structure on a branch

How to install the Neon MCP Server

claude mcp add --transport http neon https://mcp.neon.tech/mcp

Opens a browser to authorise your Neon account.

Configuration

A Neon account (free tier works). OAuth in the browser for remote mode; an API key only for automation.

VariableDescriptionRequired
NEON_API_KEYAPI key for non-OAuth local mode (automation/CI)e.g. napi_...Optional

Example prompts to try

  • “Create a branch of my main database and test adding a soft-delete column to users there.”
  • “Prepare a migration adding an index on orders(created_at) and show me the plan before applying.”
  • “Spin up a new Neon project for a demo app and give me the connection string.”

Frequently asked questions

Platform control. Generic Postgres servers query an existing database; Neon's also provisions projects, creates copy-on-write branches, stages migrations with a confirmation step and hands out connection strings. It manages the database lifecycle, not just queries.