Overview
Neon is a serverless Postgres platform that allows users to interact with their databases through natural language commands via the Model Context Protocol (MCP).
To use Neon, set up the MCP Server by running a simple initialization command with your Neon API key, and then integrate it with Claude Desktop to communicate with your database.
- Natural language processing for database management - Supported commands for project and branch management - Migration support with 'Start' and 'Commit' functionalities to handle schema changes safely - Allows CRUD operations on tables and projects
- Create new Postgres databases and manage their schemas using natural language.
- Run migrations to alter existing database structures efficiently.
- Retrieve summaries and details of various database projects seamlessly.
Add to your AI client
Use these steps to connect Neon in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"neon": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-neon"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"neon": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-neon"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"neon": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-neon"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"neon": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-neon"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"neon": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-neon"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"neon": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-neon"
]
}
}
}FAQ
What is the Model Context Protocol (MCP)?
MCP is a standardized protocol for managing the context between large language models and external systems to facilitate natural language interactions.
Do I need a special software to interact with Neon?
You need Claude Desktop and a Neon API key to use the MCP Server with Neon.
Is there specific Node.js version requirement for setting up Neon?
Yes, you need Node.js version 18.0.0 or higher to run the server successfully.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":51,"uuid":"72c28ec6-758e-412f-b814-76408a34779f","name":"neon","title":"Neon","description":"Interact with the Neon serverless Postgres platform","avatar_url":"https://r2.trys.ai/imgs/4cq6v1bd-1733450615726.png","created_at":"$D2024-12-05T16:27:19.593Z","updated_at":"$D2024-12-13T07:40:33.645Z","status":"created","author_name":"","author_avatar_url":"","tags":"neon,serverless-postgres,mcp-server","category":"cloud-platforms","is_featured":false,"sort":1,"url":"https://github.com/neondatabase/mcp-server-neon","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]