Neon MCP Server

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 tasks such as creating projects and branches, running queries, and performing database migrations without writing SQL or using the API directly. It is intended for local development and IDE integrations only, not for production environments.

How to use Neon MCP Server?

You can set up Neon MCP Server via a quick one‑command setup using npx neonctl@latest init, a remote hosted server with OAuth authentication, or a remote hosted server with an API key. Prerequisites include an MCP client, a Neon account, and Node.js 18 or higher. Configuration is done through your client’s MCP settings file (e.g., mcp.json) or with the npx add-mcp command. Read‑only mode and project scoping can be enabled through URL query parameters.

Key features of Neon MCP Server

• Natural language interaction with Neon databases
• Simplified database management without writing SQL
• Accessibility for users with varying technical backgrounds
• Database migration support using Neon’s branching capabilities
• Remote hosted server with OAuth or API key authentication
• Read‑only mode and project‑scoped access control

Use cases of Neon MCP Server

• Create a new Postgres database and tables using conversational commands
• Run database migrations on existing projects by describing the changes
• Get a summary of all Neon projects and their contents

FAQ from Neon MCP Server

Is Neon MCP Server safe for production use?

No. The README explicitly states it is intended for local development and IDE integrations only, and that it is not recommended for production environments because it can execute powerful operations that may cause accidental or unauthorized changes.

What do I need to run Neon MCP Server?

You need an MCP client application, a Neon account, Node.js version 18 or later, and if IP Allow is enabled you must add the static IPs 34.192.103.46 and 23.22.233.166 to your allowlist.

How can I restrict Neon MCP Server to read‑only operations?

You can enable read‑only mode either by selecting read‑only in the OAuth authorization UI or by adding ?readonly=true to the MCP server URL. The run_sql tool remains available but only for read‑only queries.

Can I limit Neon MCP Server to a single project?

Yes. Add the projectId query parameter to the MCP server URL (e.g., ?projectId=proj-123), and all operations will be scoped to that project.

What transport protocols does Neon MCP Server support?

It supports the recommended Streamable HTTP transport at https://mcp.neon.tech/mcp and the deprecated Server‑Sent Events (SSE) transport at https://mcp.neon.tech/sse.