Does Windsurf integrate with Neon?
Yes — via Neon's official MCP server
Yes. Neon has an official Windsurf MCP guide. In Cascade you add Neon's MCP server — either the remote server at mcp.neon.tech using browser OAuth, or a local @neondatabase/mcp-server-neon process started with npx and a Neon API key. Cascade can then list projects, run SQL and apply migrations safely on a temporary branch. A free Neon project is enough to start.
| Integration method | MCP server — Neon publishes a dedicated guide for Windsurf (the AI editor formerly Codeium, acquired by Cognition — makers of Devin — in late 2025). You add Neon's MCP server to Windsurf's Cascade config and manage your Neon Postgres in natural language. Two options exist: a remote server with OAuth (no API key) or a local server run via npx with a Neon API key. |
|---|---|
| Sync direction | Two-way: Cascade lists projects, runs SQL, and prepares/commits migrations. For schema changes the agent creates a temporary branch and tests it before committing to your production branch. |
| Plan required | A Neon free-tier account and project work. The local option additionally needs Node.js v18+ and a Neon API key; the remote OAuth option needs neither. |
| Setup time | ~10 minutes unverified estimate |
How to connect Windsurf to Neon
- Open Windsurf and launch Cascade, then click the plug icon and choose Configure to edit the mcpServers config.
- For the remote option, add a Neon entry with "url": "https://mcp.neon.tech/mcp"; for the local option add "command": "npx" with args ["-y", "@neondatabase/mcp-server-neon", "start", "<YOUR_NEON_API_KEY>"].
- Save the config; for the remote server, authorize Neon in the browser OAuth window that opens.
- Confirm Neon appears in the MCP toolbar, then test with a prompt such as "list my Neon projects".
Known friction points
- Neon states the MCP server is intended for local development and IDE integrations only, not production use, and that you should review and authorize each action the LLM requests before it runs. [source]
FAQ
- Does Windsurf integrate with Neon?
- Yes. Neon publishes an official guide for connecting Windsurf via its MCP server, letting Cascade manage your Neon Postgres in natural language.
- Do I need a Neon API key?
- Only for the local server option. The remote server at mcp.neon.tech uses browser OAuth and needs no API key; the local npx option requires a Neon API key and Node.js v18+.
- Is it safe to let the AI change my database schema?
- Neon's MCP creates a temporary branch for schema changes and tests them before committing to production, and it asks you to authorize each action. It is meant for development, not production use.
✓ Last verified: 2026-06-10 · Every claim on this page links to a primary source. If the integration changed, the page is out of date — check the sources below.
Sources
- Neon docs — Get started with Neon MCP server in Windsurf (accessed 2026-06-10)