agentskillexchange Neon Serverless Postgres MCP
Neon's official MCP server translates natural language requests into Neon API calls, letting AI agents create projects, manage branches, run SQL queries, and perform database migrations on Neon's serverless Postgres platform.
Prerequisites
MCP-compatible client (Claude Code, Cursor, VS Code), Neon account (free tier available), Node.js (for stdio mode)
Installation
Use the upstream install or setup path that matches your environment:
- npx neonctl@latest init
- npx add-mcp https://mcp.neon.tech/mcp
- npx add-mcp https://mcp.neon.tech/mcp --header "Authorization: Bearer <$NEON_API_KEY>"
- npx add-mcp https://mcp.neon.tech/sse --type sse
Requirements and caveats from upstream:
- Node.js (>= v18.0.0): Download from nodejs.org.
- For development, you'll need Node.js 22+ (pnpm is provided via Corepack — run corepack enable to activate it).
- Connect to Neon's managed MCP server using OAuth for authentication. This is the easiest setup, requires no local installation of this server, and doesn't need a Neon API key configured in the client.
Basic usage or getting-started notes:
For example, in Claude Code, or any MCP Client, you can use natural language to accomplish things with Neon, such as:
I want to run a migration on my project called "my-project" that alters the users table to add a new column called "created_at".
Quick Setup with API Key (Cursor, VS Code, and Claude Code): Run neonctl@latest init to automatically configure Neon's MCP Server, [agent skills](https://github.com/neon...
Extracted from upstream docs: https://raw.githubusercontent.com/neondatabase/mcp-server-neon/HEAD/README.md