StackMCP

Set up Neon MCP in Claude Code

Manage Neon serverless Postgres projects, branches, databases, and run SQL queries and migrations directly from your AI editor.

1

Locate the config file

Claude Code reads MCP server configuration from the following file:

~/.claude.json

Create this file if it does not already exist.

2

Add the configuration

You can configure Neon MCP using the CLI command or by editing the config file directly.

Option A: CLI command

bash
claude mcp add neon-mcp -e NEON_API_KEY=YOUR_NEON_API_KEY -- npx -y @neondatabase/mcp-server-neon

Option B: Config file

json
{
  "mcpServers": {
    "neon-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@neondatabase/mcp-server-neon"
      ],
      "env": {
        "NEON_API_KEY": "YOUR_NEON_API_KEY"
      }
    }
  }
}
3

Set up environment variables

Neon MCP requires the following environment variables:

NEON_API_KEYRequired

Neon API key for authentication

4

Verify it works

Restart Claude Code. Neon MCP should appear in your MCP server list with 18 tools available.

This server adds approximately 9,270 tokens to your context window for tool definitions.

Set up Neon MCP in other editors