Neon MCP Server

Name: Neon MCP Server
Author: neondatabase

@neondatabase

Repository Homepage

About Neon MCP Server

MCP server for interacting with Neon Management API and databases

#neon #serverless-postgres #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-neon": {
      "command": "npx",
      "args": [
        "neonctl@latest",
        "init"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Neon MCP Server?

Neon MCP Server is an open-source tool that lets you interact with your Neon Postgres databases in natural language. It acts as a bridge between natural language requests and the Neon API, enabling you to manage tasks such as creating projects and branches, running queries, and performing database migrations seamlessly.

How to use Neon MCP Server?

Set up by running npx neonctl@latest init for quick OAuth-based configuration in Cursor, VS Code, and Claude Code, or connect to the remote managed server via OAuth or an API key. You need an MCP client, a Neon account, Node.js >= 18, and if IP Allow is enabled, add the listed static IPs to your allowlist. Configure your client with the URL https://mcp.neon.tech/mcp and optionally add headers, query params, or use the deprecated SSE endpoint https://mcp.neon.tech/sse.

Key features of Neon MCP Server

Natural language interaction with Neon databases
Simplified database management without writing SQL
Accessibility for non-developers to manage databases
Database migration support using Neon's branching
Run queries, describe schemas, and view performance metrics
Read-only mode and tool category filtering for access control

Use cases of Neon MCP Server

Create a new Postgres database and a table with specified columns
Run a migration to alter an existing table
Get a summary of all Neon projects and their data
Provision Neon Auth or Data API through natural language
Reset a branch from its parent or compare database schemas

FAQ from Neon MCP Server

What is the Model Context Protocol (MCP)?

MCP is a standardized protocol designed to manage context between large language models (LLMs) and external systems. Neon MCP Server implements this protocol to bridge natural language and the Neon API.

What are the prerequisites for using Neon MCP Server?

You need an MCP client application, a Neon account, and Node.js version 18 or higher. If IP Allow is enabled on your account, you must add 34.192.103.46 and 23.22.233.166 to your allowlist.

Can I restrict the Neon MCP Server to read-only operations?

Yes. Read-only mode restricts tools to read-only actions (e.g., listing projects, querying data) and is enabled either by selecting read-only in the OAuth UI or by adding ?readonly=true to the server URL. The run_sql tool remains available only for read-only queries.

Is the Neon MCP Server recommended for production use?

No. The README warns that it is intended for local development and IDE integrations only and should not be used in production environments, as it can execute powerful operations that may lead to accidental or unauthorized changes.

How does authentication work?

Two methods: OAuth-based (recommended, no API key needed) or API key–based (set Authorization: Bearer <key> header). OAuth scopes (read, write, *) control permissions, and you can also use the org_id or project_id in prompts to scope operations to specific organizations or projects.