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.
DOCUMENTED COMMAND
npx neon@latest init 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"
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- 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
- Applicable source licence ↗Checked
https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/LICENSE
Supports: license
https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/package.json
Supports: language, review
https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/mcp/server/index.ts
Supports: language, review
https://github.com/neondatabase/mcp-server-neon/blob/e9ef5d8b7c80e3856c3c0f0608673869840d5bbd/mcp/tools/definitions.ts
Supports: language, review