Neon MCP Server
Lets you use Claude Desktop, or any MCP Client, to use natural language to accomplish things with Neon.
What is Neon MCP Server?
Neon MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to lets you use claude desktop, or any mcp client, to use natural language to accomplish things with neon.
Lets you use Claude Desktop, or any MCP Client, to use natural language to accomplish things with Neon.
This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Lets you use Claude Desktop, or any MCP Client, to use natur
Use Cases
Maintainer
Works with
Installation
NPM
npx -y neonManual Installation
npx -y neonConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Neon MCP Server
The Neon MCP Server connects any MCP-compatible AI assistant to your Neon serverless Postgres databases, enabling natural language database management without writing SQL manually. It exposes tools for creating projects and branches, running SQL queries and transactions, inspecting schemas, preparing migrations, and tuning slow queries. Teams use it to accelerate database development workflows directly from Claude Desktop, Claude Code, Cursor, or VS Code.
Prerequisites
- Node.js 18 or higher installed
- A Neon account (sign up free at console.neon.tech/signup)
- A Neon API key or OAuth access (generated in the Neon console under Account Settings)
- An MCP client such as Claude Desktop, Claude Code CLI, or Cursor
Get your Neon API key
Log in to the Neon console at console.neon.tech, navigate to Account Settings, and create a new API key. Copy it — you will need it in the next step.
Option A: Quick OAuth setup (recommended for Cursor, VS Code, Claude Code)
Run the neonctl init command, which automatically configures the MCP server with OAuth-based authentication and no manual JSON editing.
npx neonctl@latest initOption B: Remote MCP server with API key
Add the Neon remote MCP endpoint to your client configuration, passing your API key as an Authorization header. This works with any MCP client.
npx add-mcp https://mcp.neon.tech/mcp --header "Authorization: Bearer $NEON_API_KEY"Option C: Manual JSON configuration
Edit your claude_desktop_config.json or mcp.json file to add the Neon MCP server with your API key in the environment variables.
{
"mcpServers": {
"Neon": {
"command": "npx",
"args": ["-y", "neon"],
"env": {
"NEON_API_KEY": "your_neon_api_key_here"
}
}
}
}Restart your MCP client
Restart Claude Desktop, Claude Code, or your chosen MCP client to load the Neon server. The Neon tools should appear in the available tools list.
Test the connection with a natural language query
Ask your AI assistant to list your Neon projects or describe a database schema to verify the server is connected.
Neon MCP Server Examples
Client configuration
Manual configuration entry for claude_desktop_config.json using the local npx runner with a Neon API key.
{
"mcpServers": {
"Neon": {
"command": "npx",
"args": ["-y", "neon"],
"env": {
"NEON_API_KEY": "your_neon_api_key_here"
}
}
}
}Prompts to try
Use these natural language prompts once the Neon MCP server is connected.
- "Create a new Postgres database called 'my-app-db' and add a users table with id, name, email, and created_at columns"
- "List all my Neon projects and show their branch structure"
- "Run a SQL query to count rows in the orders table on my production branch"
- "Show me the slowest queries on my main database and suggest index improvements"
- "Create a new development branch from main so I can test a schema migration safely"Troubleshooting Neon MCP Server
Authentication errors when the MCP server starts
Verify your NEON_API_KEY is valid and has not expired by testing it with: curl -H 'Authorization: Bearer YOUR_KEY' https://console.neon.tech/api/v2/projects. Regenerate the key in the Neon console if needed.
run_sql tool returns permission denied errors
Ensure the Neon database role used in the connection string has the required permissions for the tables you are querying. The default 'neondb_owner' role has full access; other roles may be restricted.
npx neonctl@latest init fails or does not find the config file
Run the command from your home directory or ensure Claude Code / Cursor is already installed so neonctl can detect the config paths. You can also manually add the JSON configuration block to your claude_desktop_config.json.
Frequently Asked Questions about Neon MCP Server
What is Neon MCP Server?
Neon MCP Server is a Model Context Protocol (MCP) server that lets you use claude desktop, or any mcp client, to use natural language to accomplish things with neon. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Neon MCP Server?
Install via npm with the command: npx -y neon. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Neon MCP Server?
Neon MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Neon MCP Server free to use?
Yes, Neon MCP Server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Neon MCP Server Alternatives — Similar Databases Servers
Looking for alternatives to Neon MCP Server? Here are other popular databases servers you can use with Claude, Cursor, and VS Code.
Excelize
★ 20.6kGo language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets
MCP Toolbox for Databases
★ 15.3kOpen source MCP server specializing in easy, fast, and secure tools for Databases.
DBHub
★ 2.8kA universal database gateway MCP server that enables AI assistants to connect to and query multiple databases (PostgreSQL, MySQL, MariaDB, SQL Server, SQLite) with support for schema exploration, SQL execution, and secure connections via SSH tunnels.
Tabularis
★ 2.1kA lightweight, cross-platform database client for developers. Supports MySQL, PostgreSQL and SQLite. Hackable with plugins. Built for speed, security, and aesthetics.
Postgres AI Guide
★ 1.7kMCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
Anyquery
★ 1.7k🏎️ 🏠 ☁️ - Query more than 40 apps with one binary using SQL. It can also connect to your PostgreSQL, MySQL, or SQLite compatible database. Local-first and private by design.
Browse More Databases MCP Servers
Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Neon MCP Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Neon MCP Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.