← Explore all 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.

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

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.

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 ↗

DOCUMENTED COMMAND

npx neon@latest init

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

  1. Use the setup command or add https://mcp.neon.tech/mcp in a remote-capable client, then complete OAuth.
  2. Choose the intended project and read-only/grant restrictions before using SQL or branch tools.
  3. 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"
    }
  }
}

04 / FOLLOW THE EVIDENCE

The source trail.

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

  1. Official documentation ↗Checked

    https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/README.md

    Supports: summary, whySelected, bestFor, limitations, install, access, compatibility, transports, upstreamDescription, configExample

  2. https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/LICENSE

    Supports: license

  3. https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/package.json

    Supports: language, review

  4. https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/mcp/server/index.ts

    Supports: language, review

  5. https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/mcp/tools/definitions.ts

    Supports: language, review

Evidence & Ask