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/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 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.

If you prefer to authenticate using a Neon API key, see API key-based authentication.

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/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 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.

If you prefer to authenticate using a Neon API key, see API key-based authentication.

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

2. Click the hammer (MCP) icon, then Configure to open the configuration file (~/.codeium/windsurf/mcp_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/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.

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

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

If you prefer to authenticate using a Neon API key, 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.

If you prefer to authenticate using a Neon API key, 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.

If you prefer to authenticate using a Neon API key, see API key-based authentication.

1. Open VS Code.

2. Open your User Settings (JSON) file: Use the command palette (Ctrl+Shift+P or Cmd+Shift+P) and search for "Preferences: Open User Settings (JSON)".

3. Add the Neon MCP server configuration to your settings.json file. If the "mcp.servers" object doesn't exist, create it:

   {
     // ... your other settings ...
     "mcp": {
       "servers": {
         "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 settings.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.

If you prefer to authenticate using a Neon API key, see API key-based authentication.

For MacOS and Linux, add the following JSON configuration within the mcpServers section of your client's mcp_config file, replacing <YOUR_NEON_API_KEY> with your actual Neon API key:

"neon": {
  "command": "npx",
  "args": ["-y", "@neondatabase/mcp-server-neon", "start", "<YOUR_NEON_API_KEY>"]
}