Connect MCP Clients to Neon

The Neon MCP Server allows you to connect various Model Context Protocol (MCP) compatible AI tools to your Neon Postgres databases. This guide provides instructions for connecting popular MCP clients to the Neon MCP Server, enabling natural language interaction with your Neon projects.

This guide covers the setup for the following MCP Clients:

• Claude Desktop
• Cursor
• Windsurf (Codeium)
• Cline (VS Code extension)

By connecting these tools to the Neon MCP Server, you can manage your Neon projects, databases, and schemas using natural language commands within the MCP client interface.

Prerequisites

Before you begin, ensure you have:

• Neon Account and API Key: You need a Neon account and a Neon API key. Create an API key in your Neon Console. See Neon API Keys documentation for details.
• Node.js (>= v18.0.0) and npm: Ensure Node.js version 18 or later and npm are installed. Download them from nodejs.org.

Claude Desktop

1. Open your terminal.

2. Run the following command, replacing YOUR_NEON_API_KEY with your actual Neon API key:

   npx -y @smithery/cli install neon --client claude --config "{\"neonApiKey\":\"YOUR_NEON_API_KEY\"}"

3. Restart Claude Desktop.

For more, see Get started with Neon MCP server with Claude Desktop.

Cursor

1. Open Cursor.

2. Open your terminal.

3. Run the following command, replacing YOUR_NEON_API_KEY with your actual Neon API key:

   npx -y @smithery/cli@latest install neon --client cursor --config "{\"neonApiKey\":\"YOUR_NEON_API_KEY\"}"

4. Restart Cursor if necessary.

For more, see Get started with Cursor and Neon Postgres MCP Server.

Windsurf (Codeium)

1. Open your terminal.

2. Run the following command, replacing YOUR_NEON_API_KEY with your actual Neon API key:

   npx -y @smithery/cli@latest install neon --client windsurf --config "{\"neonApiKey\":\"YOUR_NEON_API_KEY\"}"

3. Click the Refresh button in Windsurf Cascade to load the new MCP server.

For more, see Get started with Windsurf and Neon Postgres MCP Server.

Cline (VS Code Extension)

1. Open Cline in VS Code (Sidebar -> Cline icon).

2. Open your terminal.

3. Run the following command, replacing YOUR_NEON_API_KEY with your actual Neon API key:

   npx -y @smithery/cli@latest install neon --client cline --config "{\"neonApiKey\":\"YOUR_NEON_API_KEY\"}"

For more, see Get started with Cline and Neon Postgres MCP Server.

Other MCP Clients

You can connect other MCP clients to the Neon MCP Server by running the following command in your terminal:

npx -y @smithery/cli@latest install neon --client <client_name> --config "{\"neonApiKey\":\"YOUR_NEON_API_KEY\"}"

Replace <client_name> with the name of your MCP client application and YOUR_NEON_API_KEY with your Neon API key. Supported client names include:

• witsy for Witsy
• enconvo for Enconvo

Manual configuration

If your MCP client is not listed here or you prefer manual configuration, you can manually add the Neon MCP Server details to your client's mcp_config file. The specific configuration varies slightly depending on your operating system.

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

Replace <YOUR_NEON_API_KEY> with your Neon API key.

Next Steps

Once connected, you can start interacting with your Neon Postgres databases using natural language commands within your chosen MCP client. Explore the Supported Actions (Tools) of the Neon MCP Server to understand the available functionalities.

Resources

• MCP Protocol
• Neon API Reference
• Neon API Keys
• Neon MCP server GitHub