Neon MCP Server

Official

Interact with your Lakebase Postgres databases on Neon using natural language.

How to install ↓ Compare GitHub source repository ↗

Category: Database #6 of 58
Stars: ★ 650 Very popular
Transport: Streamable HTTP · SSE
Runtime: Hosted (no local runtime)
Credentials: Optional API key
License: MIT
Last commit: 7 days ago
Tools: 34

73FMRS · B

Official Neon MCP server supporting remote hosted and local development, with comprehensive features covering project management, branching, SQL queries, migrations, optimization, authentication, and data API. Suitable for managing Neon databases via natural language, but security considerations must be addressed.

Strongest · Maintenance 18/20 Weakest · Reliability 8/20

Reliability

8/20

Security and permissions

16/20

Maintenance

18/20

Documentation

17/20

Setup experience

14/20

Why each score

Reliability 8/20: Evidence shows a comprehensive testing pyramid (unit, integration, e2e) with CI commands listed in README, including MCP protocol e2e tests. Code structure is clear (Next.js app, mcp/ directory for tools/handlers), with read-only mode and HTTP headers. However, static review did not execute tests, so actual behavior is unverified; error handling and edge cases are not adequately covered. Deduction: no execution evidence, and error handling/dependency control lacks static evidence.
Security and permissions 16/20: Evidence shows explicit security warnings in README, recommending against production use, offering OAuth and API key auth, read-only mode, project scoping (projectId), and tool category filtering, aligning with least privilege. OAuth flow has dedicated endpoints (authorize, token, revoke); secrets are managed via environment variables; connection string tools expose sensitive info but are permission-controlled. Deduction: dangerous operations like delete_project lack explicit confirmation mechanism (relying on user prompt), read-only SQL tools may still allow read operations, and data-flow disclosure is not explicit.
Maintenance 18/20: Evidence shows an active repo with 621 stars, 32 open issues, not archived, MIT license, clear dev workflow (pnpm, corepack), and CI test commands. README indicates frequent updates and feature additions (e.g., query logs, docs resources). Deduction: no explicit versioning/release policy or security response channel; dependency update strategy not detailed.
Documentation 17/20: Evidence shows a very detailed README covering multiple installation methods (quick setup, OAuth, API key), tool list with descriptions, read-only mode explanation, URL query params, SSE transport (deprecated), developer guides, and environment variable table. Deduction: more context needed for defaults like project/org IDs, and no troubleshooting or cost limit details, but overall strong.
Setup experience 14/20: Evidence shows multiple setup options including remote server URL and config examples (JSON), OAuth and API key auth, support for mainstream clients (Cursor, VS Code, Claude Code), and quick setup commands (npx add-mcp). README includes concrete client config examples. Deduction: static review did not verify installation, and dependency on Node.js and Corepack may complicate non-Node environments; lacks detailed step-by-step troubleshooting.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account dataConnects to a database

Best for

Developers and non-developers who want to manage Neon databases via natural language.
Users who want to perform database tasks quickly within IDEs or chat interfaces.
Teams needing safe migrations and query optimization.

Not for

Production environments requiring fine-grained control.
Users needing a full SQL interface and complex transaction handling.
Users who want to run fully offline or without depending on remote services.

Required permissions

Neon account and authentication (OAuth or API key).
Access, create, modify, and delete Neon projects, branches, databases, and resources.
Execute SQL queries (read/write).
Manage authentication and Data API configurations.
Read logs and documentation index.

Risks and side effects

Natural language requests may accidentally execute destructive operations (e.g., deleting projects or branches).
Unauthorized individuals may access your account via API key or OAuth.
Production use carries risk of accidental changes; official recommendation is for local development only.
Careful review of LLM-proposed actions is required.

Setup

Before you start

Runtime：Hosted (no local runtime)

Install an MCP client (e.g., Claude Desktop, Cursor).
Connect to the remote server using OAuth or API key:

OAuth: Run npx add-mcp https://mcp.neon.tech/mcp or configure {"mcpServers":{"Neon":{"type":"http","url":"https://mcp.neon.tech/mcp"}}} and follow the browser OAuth flow.
API key: Create a Neon API key and configure {"mcpServers":{"Neon":{"type":"http","url":"https://mcp.neon.tech/mcp","headers":{"Authorization":"Bearer <API_KEY>"}}}}.

Restart or refresh your MCP client.

claude_desktop_config.json

{
  "mcpServers": {
    "Neon": {
      "type": "http",
      "url": "https://mcp.neon.tech/mcp"
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

{
  "servers": {
    "Neon": {
      "type": "http",
      "url": "https://mcp.neon.tech/mcp"
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

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

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After connecting the client to https://mcp.neon.tech/mcp and completing the OAuth flow, refresh the client — tools such as list_projects should appear in the tool list; asking the client to 'list my Neon projects' confirms the connection works.

Troubleshooting

Connection failures: Check network proxy/firewall and ensure client supports streamable-http.
Authentication errors: Re-authorize OAuth or verify API key validity.
Tools unavailable: Check if read-only mode or tool category restrictions are enabled.
Project access: Confirm project belongs to personal account or provide organization ID.
IP allowlist: If IP Allow is enabled, add IPs `34.192.103.46` and `23.22.233.166` to allowlist.

Things to try

Once connected, you can ask your AI assistant things like:

List all of my Neon projects and summarize what data is in each one.
Create a new Postgres database called my-database in my project, then create a users table with columns id, name, email, and password.
Run a migration on my project my-project that alters the users table to add a new column called created_at.
Find the slowest queries in my database and explain their execution plans.

Tools 34

list_projects read-only

Lists the first 10 Neon projects in your account.

list_shared_projects read-only

Lists Neon projects shared with the current user.

describe_project read-only

Fetches detailed information about a specific Neon project.

create_project writes

Creates a new Neon project in your account.

delete_project destructive

Deletes an existing Neon project and all associated resources.

list_organizations read-only

Lists all organizations the current user has access to.

create_branch writes

Creates a new branch within a specified Neon project.

delete_branch destructive

Deletes an existing branch from a Neon project.

Show 26 more tools

describe_branch read-only

Retrieves details about a specific branch.

list_branch_computes read-only

Lists compute endpoints for a project or branch.

compare_database_schema read-only

Shows schema diff between child branch and parent.

reset_from_parent destructive

Resets the current branch to its parent's state.

get_connection_string read-only

Returns your database connection string.

run_sql writes

Executes a single SQL query against a Neon database.

run_sql_transaction writes

Executes a series of SQL queries within a single transaction.

get_database_tables read-only

Lists all tables within a specified Neon database.

describe_table_schema read-only

Retrieves schema definition of a specific table.

prepare_database_migration writes

Initiates a migration, creating a temporary branch for safe testing.

complete_database_migration writes

Finalizes and applies a prepared migration to the main branch.

list_slow_queries read-only

Identifies slowest queries in a database.

explain_sql_statement read-only

Provides detailed execution plans for SQL queries.

prepare_query_tuning writes

Analyzes query performance and suggests optimizations, creating a temporary branch.

complete_query_tuning writes

Finalizes query tuning by applying or discarding optimizations.

provision_neon_auth writes

Provisions Neon Auth for a project.

configure_neon_auth writes

Configures an existing Neon Auth integration.

get_neon_auth_config read-only

Reads Neon Auth configuration for a branch.

provision_neon_data_api writes

Provisions the Neon Data API for HTTP-based access.

search read-only

Searches across organizations, projects, and branches.

fetch read-only

Fetches detailed information about a specific entity.

query_logs read-only

Queries logs emitted by serverless functions.

list_log_fields read-only

Lists log fields you can filter on.

list_log_field_values read-only

Lists distinct values of a log field.

list_docs_resources read-only

Lists all available Neon documentation pages.

get_doc_resource read-only

Fetches a specific documentation page as markdown.

Use cases

Create and manage Neon projects and branches using natural language.

Execute SQL queries and transactions through conversation.

Run database migrations without writing SQL manually.

Analyze query performance and optimize slow queries.

Configure Neon Auth and Data API.

Supported clients

Claude Desktop

Cursor

VS Code

Claude Code

Kiro

Listed from the project's documentation, not tested by this site.

Overview

The Neon MCP Server is an open-source tool from Neon that lets you interact with your Lakebase Postgres databases on Neon in natural language. It acts as a bridge between natural language requests and the Neon API, translating your requests into necessary API calls. This enables you to manage projects, branches, run queries, and perform database migrations seamlessly. It offers a remote hosted server with OAuth or API key authentication, as well as local development options.

Similar servers

MCP ClickHouse 79 · B

Connect ClickHouse to your AI assistants

★ 883 · Tools 4 Compare with this →

ChEMBL MCP Server 75 · B

Unofficial MCP server providing advanced access to the ChEMBL chemical database

★ 89 · Tools 27 Compare with this →

MCP Toolbox for Databases 74 · B

Google's official database MCP toolbox — define AI-accessible database tools via config

★ 16.6k Compare with this →

DBHub 74 · B

Bytebase's official, minimalist two-tool database MCP server

★ 3.6k · Tools 2 Compare with this →

Compare with other MCP servers

Source revision 185d5ee7a1ed Data synced 2026-10-11 Read the FMRS scoring method