How to connect the Neon MCP server

To connect the official Neon MCP server, add https://mcp.neon.tech/mcp to your MCP client as a Streamable HTTP server, then sign in with OAuth when your client prompts you. If your client can't use OAuth, use a Neon API key. Neon documents setup for Cursor, Claude Code, Codex and Claude.

Docs reviewed 5 Nov 2026Not a tested connection.

Try with your key via relay → Neon blocks requests from other websites, so the explorer uses API Tracker's relay. Anything you enter passes through it and is never stored or logged.

Endpoint https://mcp.neon.tech/mcp · Registry com.neon/mcp 1.0.0

Open in the Neon MCP explorer →Neon API profile →Markdown for agents

Add Neon MCP to your client

My client can't use OAuth: send a key from NEON_API_KEY

~/.cursor/mcp.json

{
  "mcpServers": {
    "neon": {
      "url": "https://mcp.neon.tech/mcp"
    }
  }
}

neon.com/docs

Connect Neon MCP step by step

Before you start

A Neon account with the projects the assistant should work on. With OAuth you authorize access to your Neon account in the browser. neon.com/docs
Neon recommends MCP for development and testing only. Don't connect it to production databases or to production or personal data; review each action the assistant asks to run. neon.com/docs
If your project uses IP allowlisting, allow the hosted server's outbound addresses listed in Neon's MCP documentation. neon.com/docs

Authentication

Your client → Neon MCP: OAuth sign-in, handled by your MCP client. neon.com/docs modelcontextprotocol.io/specification
Neon MCP → Neon API: The server acts on your account with the access you approve. neon.com/docs

Steps

Open Neon's MCP server setup instructions
neon.com/docs/ai/neon-mcp-server
Add the Neon MCP server to your client
Add https://mcp.neon.tech/mcp as a remote MCP server that uses the Streamable HTTP transport. Neon also publishes a config generator, a plugin for Cursor, Claude Code and Codex, and an official Claude connector for Claude.ai and Claude Desktop. The older SSE endpoints are retired and return 410 Gone, and the local stdio package is deprecated.
neon.com/docs registry.modelcontextprotocol.io/v0.1
Optional: limit what the assistant can do
To restrict the server to read operations, append ?readonly=true to the server URL, or choose read-only scope during OAuth authorization. You can also scope the server to one project, filter tool categories, or set a Postgres role for SQL tools with URL parameters described in Neon's documentation.
neon.com/docs
Optional: x-read-only header
registry.modelcontextprotocol.io/v0.1 neon.com/docs
Authorize access to your Neon account in the browser
neon.com/docs
If your client can't use OAuth, use a Neon API key
Create a Neon API key and send it as a bearer token in the Authorization header. Keep the key in an environment variable or secret store, not in shared configuration.
neon.com/docs neon.com/docs
API key only: Authorization
registry.modelcontextprotocol.io/v0.1 neon.com/docs
List the server's tools
Your client should list the server's tools. That confirms the connection, not every API permission.
neon.com/docs

What we observed

5 Nov 2026: HTTP 401 with WWW-Authenticate resource_metadata https://mcp.neon.tech/.well-known/oauth-protected-resource/mcp, which names the authorization server https://mcp.neon.tech.

Neon MCP questions

What is the Neon MCP server URL?

The official Neon MCP server is at https://mcp.neon.tech/mcp and uses the Streamable HTTP transport.

How do I authenticate with the Neon MCP server?

Sign in with OAuth when your client prompts you. If your client can't use OAuth, use a Neon API key: Create a Neon API key and send it as a bearer token in the Authorization header. Keep the key in an environment variable or secret store, not in shared configuration.

Which AI clients can use the Neon MCP server?

Neon's documentation covers Cursor, Claude Code, Codex and Claude. Other clients that support remote Streamable HTTP MCP servers may also work.

What do I need before connecting Neon MCP?

A Neon account with the projects the assistant should work on. With OAuth you authorize access to your Neon account in the browser. Neon recommends MCP for development and testing only. Don't connect it to production databases or to production or personal data; review each action the assistant asks to run. If your project uses IP allowlisting, allow the hosted server's outbound addresses listed in Neon's MCP documentation.

Has this Neon MCP guide been tested?

Neon's documentation was reviewed on 2026-11-05. It is not a tested connection; your account and permissions decide which tools work.

Sources and review

Neon's documentation was checked on the dates shown. This guide follows the MCP Connect connection-guide draft, bound to the exact Registry record it describes. It is not a tested connection: your account and permissions decide which tools work.

Guide source and binding

MCP connection guide (draft 0.1) for com.neon/mcp 1.0.0, bound to /remotes/0 of the Registry record by SHA-256 3011898f9dc3….

Guide JSON Source snapshot

neon.com/docs/ai/neon-mcp-server · checked 5 Nov 2026
neon.com/docs/manage/api-keys#creating-api-keys · checked 5 Nov 2026
registry.modelcontextprotocol.io/v0.1/servers/com.neon%2Fmcp/versions/1.0.0 · checked 5 Nov 2026
modelcontextprotocol.io/specification/2026-07-28/basic/authorization · checked 5 Nov 2026

All MCP connection guides →How we review MCPs →