How to add Neon MCP Server to Claude Desktop

Manage serverless Postgres on Neon with natural language: projects, branches, migrations, and SQL. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 2.1k★ · http · oauth · official

Claude Desktop config for Neon MCP Server

npx -y mcp-remote https://mcp.neon.tech/mcp

{
  "mcpServers": {
    "neon-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.neon.tech/mcp"
      ]
    }
  }
}

Claude Desktop connects to remote servers through the `mcp-remote` proxy (installed on first run via npx). Restart Claude Desktop after saving.

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Neon MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Neon MCP Server's tools appear under the 🔌 tools menu.

Before you start

A Neon account (sign up at console.neon.tech)
An MCP-capable client (Cursor, VS Code, Claude Code, Claude Desktop, etc.)
For the remote server: just a browser for the OAuth flow — no API key needed
For API-key auth or local use: a Neon API key from the Neon Console (passed as Authorization: Bearer <key>), and Node.js 18+ (the mcp-remote bridge / local server run via npx)

What Neon MCP Server can do in Claude Desktop

list_projects / describe_project / create_project / delete_project

Manage Neon projects

create_branch / delete_branch / describe_branch / reset_from_parent

Create and manage database branches

run_sql / run_sql_transaction

Execute a single SQL statement or a transaction

get_connection_string

Retrieve a connection string for a project/branch

get_database_tables / describe_table_schema

Inspect tables and their schemas

compare_database_schema

Diff schemas between branches

prepare_database_migration / complete_database_migration

Two-step safe migration: test on a temp branch, then promote

list_slow_queries / explain_sql_statement

Find slow queries and inspect execution plans

Security

The server can create, modify, and delete Neon projects and run arbitrary SQL, so the OAuth grant is powerful; review the authorization scope. The standalone @neondatabase/mcp-server-neon npm package is deprecated, so prefer the remote OAuth endpoint.

Neon MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Neon MCP Server config there under the "mcpServers" key and restart the client.

Is Neon MCP Server safe to use with Claude Desktop?

OAuth or API key — which should I use?

OAuth is recommended for the hosted server and needs no key handling. Use an API key (from the Neon Console, sent as Authorization: Bearer <key>) for headless/CI setups or clients that can't do the browser flow.

What is mcp-remote for?

It is a bridge that lets stdio-only MCP clients connect to Neon's hosted HTTP endpoint at mcp.neon.tech. Clients that support remote HTTP servers can connect directly without it.

Why does migration use two steps?

prepare_database_migration applies your change on a temporary branch so it can be verified against real data; complete_database_migration then promotes it. This prevents an agent from breaking your main branch.

View repo Full Neon MCP Server page