Connect MCP Clients to Neon

1. Open Claude desktop and navigate to Settings.

2. Under the Developer tab, click Edit Config (On Windows, it's under File -> Settings -> Developer -> Edit Config) to open the configuration file (claude_desktop_config.json).

3. Add the "Neon" server entry within the mcpServers object:

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

   To use SSE instead of streamable HTTP responses, you can specify the https://mcp.neon.tech/sse endpoint instead of https://mcp.neon.tech/mcp.

4. Save the configuration file and restart Claude Desktop.

5. An OAuth window will open in your browser. Follow the prompts to authorize Claude Desktop to access your Neon account.

By default, the Remote MCP Server connects to your personal Neon account. To connect to an organization's account, you must authenticate with an API key. For more information, see API key-based authentication.

1. Ensure you have Claude Code installed. Visit docs.anthropic.com/en/docs/claude-code for installation instructions.
2. Open terminal and add Neon MCP with

   claude mcp add --transport http neon https://mcp.neon.tech/mcp

3. Start a new session of claude to trigger OAuth authentication flow
4. You can also trigger authentication with /mcp within Claude Code.

If you prefer to authenticate using a Neon API key, provide Authorization header to mcp add command:

claude mcp add --transport http neon https://mcp.neon.tech/mcp \
    --header "Authorization: Bearer <YOUR_NEON_API_KEY>"

Replace <YOUR_NEON_API_KEY> with your actual Neon API key which you obtained from the prerequisites section

Quick Install (Recommended)

Click the button below to install the Neon MCP server in Cursor. When prompted, click Install within Cursor.

Manual Setup

1. Open Cursor. Create a .cursor directory in your project root if needed.

2. Create or open the mcp.json file in the .cursor directory.

3. Add the "Neon" server entry within the mcpServers object:

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

   To use SSE instead of streamable HTTP responses, you can specify the https://mcp.neon.tech/sse endpoint instead of https://mcp.neon.tech/mcp.

4. Save the configuration file. Cursor may detect the change or require a restart.

5. An OAuth window will open in your browser. Follow the prompts to authorize Cursor to access your Neon account.

By default, the Remote MCP Server connects to your personal Neon account. To connect to an organization's account, you must authenticate with an API key. For more information, see API key-based authentication.

1. Open Windsurf and navigate to the Cascade assistant sidebar.

2. Click the hammer (MCP) icon, then Configure which opens up the "Manage MCPs" configuration file.

3. Click on "View raw config" to open the raw configuration file in Windsurf.

4. Add the "Neon" server entry within the mcpServers object:

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

   To use SSE instead of streamable HTTP responses, you can specify the https://mcp.neon.tech/sse endpoint instead of https://mcp.neon.tech/mcp.

5. Save the file.

6. Click the Refresh button in the Cascade sidebar next to "available MCP servers".

7. An OAuth window will open in your browser. Follow the prompts to authorize Windsurf to access your Neon account.

By default, the Remote MCP Server connects to your personal Neon account. To connect to an organization's account, you must authenticate with an API key. For more information, see API key-based authentication.

1. Open Cline in VS Code (Sidebar -> Cline icon).
2. Click MCP Servers Icon -> Installed -> Configure MCP Servers to open the configuration file.
3. Add the "Neon" server entry within the mcpServers object:

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

For streamable HTTP responses instead of SSE, you can specify the https://mcp.neon.tech/mcp endpoint instead of https://mcp.neon.tech/sse.

4. Save the file. Cline should reload the configuration automatically.
5. An OAuth window will open in your browser. Follow the prompts to authorize Cline to access your Neon account.

By default, the Remote MCP Server connects to your personal Neon account. To connect to an organization's account, you must authenticate with an API key. For more information, see API key-based authentication.

1. Open the Zed Preview application.

2. Click the Assistant (✨) icon in the bottom right corner.

3. Click Settings in the top right panel of the Assistant.

4. In the Context Servers section, click + Add Context Server.

5. Configure the Neon Server:

   • Enter Neon in the Name field.

   • In the Command field, enter:

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

   • Click Add Server.

   For streamable HTTP responses instead of SSE, you can specify the https://mcp.neon.tech/mcp endpoint instead of https://mcp.neon.tech/sse.

6. An OAuth window will open in your browser. Follow the prompts to authorize Zed to access your Neon account.

7. Check the Context Servers section in Zed settings to ensure the connection is successful. "Neon" should be listed.

By default, the Remote MCP Server connects to your personal Neon account. To connect to an organization's account, you must authenticate with an API key. For more information, see API key-based authentication.

1. Open VS Code.

2. Create a .vscode folder in your project's root directory if it doesn't exist.

3. Create or open the mcp.json file in the .vscode directory and add the following configuration into the file (if you have other MCP servers configured, add the "Neon" server entry within the servers object):

   {
     "servers": {
       "Neon": {
         "url": "https://mcp.neon.tech/mcp",
         "type": "http"
       }
     },
     "inputs": []
   }

   For streamable HTTP responses instead of SSE, you can specify the https://mcp.neon.tech/mcp endpoint instead of https://mcp.neon.tech/sse.

4. Save the mcp.json file.

5. Click on Start on the MCP server.

6. An OAuth window will open in your browser. Follow the prompts to authorize VS Code (GitHub Copilot) to access your Neon account.

7. Once authorized, you can now open GitHub Copilot Chat in VS Code and switch to Agent mode. You will see the Neon MCP Server listed among the available tools.

By default, the Remote MCP Server connects to your personal Neon account. To connect to an organization's account, you must authenticate with an API key. For more information, see API key-based authentication.