Neon · neon — Claude Code MCP server: PostgreSQL management
Manage Neon projects, branches, and databases directly from Claude Code, Cursor, or GitHub Copilot. Execute SQL queries, create temporary branches for safe schema migrations, and optimize query performance with built-in analysis.
no license 1,350 installs updated 2026-01-29
claude mcp add --transport http neon https://neon.run.toolsWhat Neon does
Neon is an MCP server that connects eight IDEs and code assistants to Neon's database management platform. You can list and create projects, execute SQL statements and transactions, manage branches, inspect table schemas, and compare database structures across branches.
For safe migrations, the server creates temporary branches where you test DDL changes separately before applying them to production. Slow query detection hooks into pg_stat_statements to surface performance bottlenecks and suggest optimizations based on execution plans.
The server also provisions Neon Auth (a managed authentication layer) and Neon Data API (HTTP endpoints for database access with JWT). You need a Neon account to use it; the server communicates with https://neon.run.tools.
What it helps with
- Run a SQL query against a Neon database without leaving the IDE
- Test a schema migration on a temporary branch before deploying to the main database
- Identify slow queries and get performance tuning recommendations
- Check what changed in the database schema between two branches
- Set up Neon Auth or the Data API on a branch in one step
Example prompts for the agent
- List all my Neon projects and show details for the one named "app-db"
- Create a temporary branch and add an
emailcolumn to theuserstable, then explain the changes - Which queries are running slowest in my database right now?
How to install Neon
Platform CLI: remote server
claude mcp add --transport http neon https://neon.run.toolsPlatform CLI: remote server
codex mcp add neon-neon --url https://neon.run.toolsConfig file
{
"mcpServers": {
"neon-neon": {
"url": "https://neon.run.tools"
}
}
}Config file
{
"servers": {
"neon-neon": {
"type": "http",
"url": "https://neon.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http neon-neon https://neon.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Neon
How do I install Neon in Claude Code?
Run claude mcp add --transport http neon https://neon.run.tools. For Codex, use codex mcp add neon-neon --url https://neon.run.tools. For Cursor, add an entry to your config: {"neon-neon": {"url": "https://neon.run.tools"}}.
What does the Neon MCP server do?
It gives your AI assistant access to manage Neon projects, branches, and PostgreSQL databases from your IDE. You can run SQL, create branches for testing migrations, analyze slow queries, and provision services like managed auth and HTTP APIs.
Do I need a Neon account to use this server?
Yes. You need a Neon account with at least one project. The server communicates with your Neon account via API.
Similar MCP servers
All MCP servers for Backend and APIs →Neon by other authors comes first.