Neon MCP Server
Neon Postgres database management through natural language interface commands.
Data last scanned today · Reviewed today
Overview
Neon MCP Server translates conversational natural language requests into direct Neon API calls. This tool facilitates database management tasks including project creation, branch management, query execution, and database schema migrations without requiring direct SQL manipulation or manual API usage. By leveraging the Model Context Protocol, the server allows AI models to bridge the gap between user intent and database operations. This approach is designed to simplify complex workflows for both technical and non-technical users interacting with Neon projects.
Our verdict
This server carries a high risk level with a security score of 45/100. Because the authentication methods and read-only support have not yet been editorially reviewed, users should exercise extreme caution when granting this tool access to sensitive database environments. It is recommended for development and testing environments only, rather than production systems, until more robust security auditing is completed.
- Supports complex database migrations and branching workflows
- Open-source implementation released under the MIT license
- Active development evidenced by recent daily commits
- Small footprint with only 20 direct dependencies
- Security review for read-only mode is currently pending
- Lacks authentication security verification for API access
- Maintained by the community rather than the official vendor
Setup
{
"mcpServers": {
"mcp-server-neon": {
"args": [
"-y",
"@neondatabase/mcp-server-neon"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| list_projects | Lists Neon projects. | low |
| describe_project | Fetches a Neon project by id. | low |
| create_project | Creates a Neon project and waits for the default compute. | medium |
| delete_project | Deletes an existing Neon project. | high |
| list_organizations | Lists all organizations that the current user has access to. | low |
| list_branches | Lists branches in a project. | low |
| create_branch | Creates a branch with a read-write compute and waits until it is ready. | medium |
| reset_from_parent | Resets a branch to its parent's current HEAD. | high |
| delete_branch | Deletes a branch. | high |
| describe_branch | Retrieves a tree of databases, schemas, tables, views, and functions on a branch. | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| ChatGPT | ||||
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf |
Frequently asked questions
›What are the security recommendations for this server?
This server is intended for local development and IDE integrations only; it is not recommended for production environments. You should always review and authorize actions requested by the LLM before execution.
›What are the system requirements for running the server?
You need a Neon account, an MCP-compliant client application, and Node.js version 18.0.0 or higher.
›What network configuration is required if I use IP Allow?
If you have IP Allow enabled on your Neon account, you must add the static IPs 34.192.103.46 and 23.22.233.166 to your allowlist.
›How can I set up the server without manually creating an API key?
You can use OAuth-based authentication by connecting to the remote managed MCP server, which eliminates the need to manage API keys manually.
›What is the simplest way to configure the server for editors like Cursor or VS Code?
You can run 'npx neon@latest init' to automatically configure the MCP server, agent skills, and your editor integration in one command.
Alternatives
Badge
Maintain this server? Add the live badge to your README.