---
title: "Neon MCP Server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/neon/
description: "Manages Neon Postgres projects, branches and SQL through a hosted connection with project and grant-based tool filtering."
---

# Neon MCP Server: review, setup & limitations · Undominated.ai

> Manages Neon Postgres projects, branches and SQL through a hosted connection with project and grant-based tool filtering.

[← Explore all mcp servers](/mcp-servers/)

DATABASE DEVELOPMENT / Neon

# Neon MCP Server

Manages Neon Postgres projects, branches and SQL through a hosted connection with project and grant-based tool filtering.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/neondatabase/mcp-server-neon)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 5 linked sources
 Publisher Neon
 Licence [MIT ↗](https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/LICENSE)
 Revision e9ef5d8b7c80
 [Read what was—and wasn’t—checked ↓](#review)

“Neon MCP Server is an open-source tool that lets you interact with your Lakebase Postgres databases on Neon in natural language.”

 [Neon · upstream description ↗](https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/README.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Branch tools make the server useful for database development tasks beyond generic SQL execution.
- Source tool definitions expose read/write annotations and server-side read-only handling.

### A good fit for

 - Inspecting a development branch or comparing its schema with another branch.
- Read-only SQL against one project through a fixed grant URL (readonly=true&projectId=...).

### Weigh up before choosing

 - Writes are enabled unless read-only access is explicitly requested.
- Category filters are not a read-only switch: branch categories include creation and other mutations.
- The README says the server is intended for local development and IDE integrations and does not recommend it in production environments.
- explain_sql_statement stays available in read-only mode; its description says that with analyze true PostgreSQL executes the statement and any side effects. Whether read-only mode wraps it in a read-only transaction was not established.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - README.md at e9ef5d8b7c80e3856c3c0f0608673869840d5bbd (setup options, scopes and read-only mode, tool list, remote architecture)
- package.json, mcp/server/index.ts and mcp/tools/definitions.ts at the same commit
- LICENSE at the same commit

### Our findings

 - The server initializes readOnly from request context with false as the fallback.
- SQL tools are marked destructive, and project/branch tools include deletion and reset operations.
- Read-only mode is set by unchecking Allow writes on the OAuth page, or by readonly=true on the MCP URL (the only way in the API-key flow); in it, run_sql runs each query in a READ ONLY transaction.
- Changed since a7b29270: run_sql_transaction is no longer read-only-safe (a COMMIT or SET TRANSACTION READ WRITE inside it could end the read-only transaction), explain_sql_statement is now annotated destructive, and a send_feedback tool sends anonymous feedback text to Neon.
- Management API tools are generated from @neon/tools; host tools are defined in mcp/tools/definitions.ts with a readOnlySafe flag that decides read-only availability.
- The README documents a deprecated SSE endpoint at https://mcp.neon.tech/sse beside Streamable HTTP at /mcp.
- configExample is the README's read-only block (Scopes and Read-Only Mode) at e9ef5d8b.

### Not established by this review

 - Server startup, authentication and tool execution were not tested.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/README.md)

DOCUMENTED COMMAND

 npx neon@latest init Copy command ↗

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

 - Use the setup command or add https://mcp.neon.tech/mcp in a remote-capable client, then complete OAuth.
- Choose the intended project and read-only/grant restrictions before using SQL or branch tools.
- The README says the init command authenticates via OAuth, creates a Neon API key and configures Cursor, VS Code or Claude Code. It was copied from the README and not run.

### Before you start

 - A Neon account; Node.js is needed for the setup command.

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 {
 "mcpServers": {
 "Neon": {
 "url": "https://mcp.neon.tech/mcp?readonly=true"
 }
 }
} Copy configuration ↗

### Compatibility

An MCP client supporting Streamable HTTP. · A Neon account; Node.js is needed for the setup command.

### Implementation

TypeScript

### Transports

Streamable HTTP · SSE

### Hosted Neon connection / OAuth or API credentials

 - Accesses project metadata, database credentials and SQL according to the grant.
- Enabled tools can create, reset or delete branches and projects, and change database data.
- Authenticates by OAuth (scopes read and write) or by a Neon API key sent as a Bearer token in the Authorization header; an organization API key limits access to that organization's projects.

### Cost model

Neon database, compute and account usage determine cost.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Official documentation ↗](https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/README.md) Checked 2026-10-13 https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/README.md Supports: summary, whySelected, bestFor, limitations, install, access, compatibility, transports, upstreamDescription, configExample
- [Applicable source licence ↗](https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/LICENSE) Checked 2026-10-13 https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/LICENSE Supports: license
- [Implementation: package.json ↗](https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/package.json) Checked 2026-10-13 https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/package.json Supports: language, review
- [Implementation: mcp/server/index.ts ↗](https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/mcp/server/index.ts) Checked 2026-10-13 https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/mcp/server/index.ts Supports: language, review
- [Implementation: mcp/tools/definitions.ts ↗](https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/mcp/tools/definitions.ts) Checked 2026-10-13 https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/mcp/tools/definitions.ts Supports: language, review

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Supabase MCP ↗ Connects an assistant to Supabase project data and configuration, with project, feature-group and read-only restrictions available in the server URL.](/mcp-servers/supabase/)[### Aurora DSQL MCP ↗ AWS Labs MCP server that turns questions into Postgres-compatible SQL for Aurora DSQL, read-only unless --allow-writes is passed, and only on the same host as the client.](/mcp-servers/awslabs-aurora-dsql/)[### Aurora MySQL MCP ↗ AWS Labs MCP server that turns natural language into SQL for Aurora MySQL on the same host as the client, with a keyword guard the README says is not a security boundary.](/mcp-servers/awslabs-mysql/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
