MCP server Official

Neon MCP Server

Neon's official MCP server: manage Neon Postgres projects, branches, schemas and migrations, and run queries in natural language.

Author: Neon
Works with: Any MCP client, Claude Code, Cursor
License: MIT
Documented: Oct 2, 2026

Repository ↗ Official docs ↗

What Neon MCP Server is

Neon MCP Server is an open-source bridge between natural language requests and the Neon API. It is offered as a hosted remote server at mcp.neon.tech with OAuth or API key auth. It can create projects and branches, run queries and perform migrations.

What it does

Where Neon MCP Server runs and what it adds, from its documentation

Create and manage Neon projects, branches and compute endpoints
Run SQL queries and inspect schemas
Safe migrations: prepare_database_migration tests on a temporary branch, complete_database_migration applies it
Tool scopes (projects, branches, endpoints, snapshots, schema, querying, neon_auth, data_api, observability, docs) for filtering
Read-only mode via readonly=true or OAuth consent

When to use it

Good fit

Local development with a Neon database from your IDE or agent
Schema migrations tested on a branch before applying
Summarizing what is in your Neon projects

Not for

Production environments (README does not recommend it)
Unreviewed autonomous actions; actions must be reviewed and authorized

How to install Neon MCP Server

You need: An MCP client; A Neon account; Node.js >= 18; If IP Allow is enabled, allowlist 34.192.103.46 and 23.22.233.166

Quick: npx neon@latest init (Cursor, VS Code, Claude Code)
Or OAuth remote: npx add-mcp https://mcp.neon.tech/mcp
Or add the Neon entry with the remote URL to your client's MCP config
Restart the client and complete the OAuth window in the browser

Configuration example (from the official docs)

{
  "mcpServers": {
    "Neon": {
      "type": "http",
      "url": "https://mcp.neon.tech/mcp?category=projects&category=branches&category=endpoints&category=querying&category=schema"
    }
  }
}

Permissions and security

What it can access

Neon account projects via OAuth or API key
OAuth scopes read and write; organization API key limits access to that org

Security notes from the maintainers

Grants powerful database management; always review actions requested by the LLM
Telemetry: sends account ID, name, email and tool names to track.neon.tech and errors to Sentry; NEON_MCP_DISABLE_ANALYTICS=1 disables analytics only for self-run

Review the source before granting an agent access to credentials or production systems. We document what the maintainers state; we do not audit code.