Neon MCP server
Neon's official remote server for Neon Postgres projects, branches, SQL queries and guided schema migrations. Authorize through OAuth; intended for development, not production databases.
Remote (HTTP)OAuth
Set up Neon
Configuration examples, not tested connections. Replace placeholders and review the upstream documentation before use.
Claude Code
Run in your terminal.
claude mcp add --transport http neon https://mcp.neon.tech/mcp
Cursor
Merge into ~/.cursor/mcp.json
{
"mcpServers": {
"neon": {
"url": "https://mcp.neon.tech/mcp"
}
}
}
Codex
Run in your terminal.
codex mcp add neon --url https://mcp.neon.tech/mcp
codex mcp login neon
Gemini CLI
Merge into ~/.gemini/settings.json
{
"mcpServers": {
"neon": {
"httpUrl": "https://mcp.neon.tech/mcp"
}
}
}
OpenCode
Merge into ~/.config/opencode/opencode.jsonc
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"neon": {
"type": "remote",
"url": "https://mcp.neon.tech/mcp",
"enabled": true
}
}
}
VS Code
Merge into .vscode/mcp.json
{
"servers": {
"neon": {
"type": "http",
"url": "https://mcp.neon.tech/mcp"
}
}
}
Using more than one server?Add to a config with other servers
Step-by-step setup guides: Claude Code and Codex CLI, Cursor and VS Code. In Claude Desktop, add the URL as a custom connector. This is a remote server with OAuth sign-in; see remote vs local servers and authentication and security basics.
Overview
Neon maintains its MCP server in neondatabase/mcp-server-neon, which had commits on 4 October 2026, and runs it as a managed remote at https://mcp.neon.tech/mcp. It lets an agent manage Neon serverless Postgres in natural language: create projects and branches, run queries and plan schema changes.
Commonly used tools include list_projects and describe_project, create_branch for isolated work, run_sql and describe_table_schema for queries and inspection, and get_connection_string. Schema changes follow a two-step flow. prepare_database_migration applies a change on a temporary branch, and complete_database_migration applies it to the main branch after you review it. Read-only mode restricts the tool set, and run_sql then only allows read-only queries.
The example uses OAuth. When you connect, a browser window asks you to authorize the client, and by default it works with projects in your personal Neon account; upstream explains how to reach organization projects. A remote API-key option and a category filter on the URL are also documented. Neon states plainly that the server is meant for local development and IDE integrations, and does not recommend using it in production, because it can run powerful operations. Point it at development projects and review every migration before you complete it.
Example tools
list_projectscreate_branchrun_sqldescribe_table_schemaprepare_database_migrationget_connection_string
Tool names are upstream examples. The server's live tool list can differ.
Related Database servers
Sources
This page was written from the upstream documentation below and last reviewed on 11 October 2026. Listing is not a security or compatibility endorsement. Report a correction through the contact page.