Does Windsurf integrate with Supabase?
Yes — via Supabase's official MCP server
Yes. Windsurf connects to Supabase through Supabase's official MCP server at mcp.supabase.com. You add the server to Windsurf's mcp_config.json, sign in to Supabase in the browser during setup, and Cascade can then read your schema, run queries and apply migrations. Scope the server to read-only or a single project for safety. Free tiers on both sides are enough to begin.
| Integration method | MCP server — Windsurf (the AI editor formerly Codeium, acquired by Cognition — makers of Devin — in late 2025) connects to Supabase through Supabase's official remote MCP server. You add the server to Windsurf's mcp_config.json and Cascade can then query and manage your Postgres database in natural language. No Zapier or Make is involved. |
|---|---|
| Sync direction | Two-way: Cascade reads your schema and runs queries, and can execute writes/migrations against your Supabase Postgres unless you scope the server to read-only. |
| Plan required | Free tiers on both sides work. A Supabase free-tier project and any Windsurf plan that supports MCP are enough to start. |
| Setup time | ~10 minutes unverified estimate |
How to connect Windsurf to Supabase
- In Windsurf, open Cascade and the MCP / plugin configuration panel, which edits ~/.codeium/windsurf/mcp_config.json.
- Add the Supabase MCP server under mcpServers, pointing at the official endpoint https://mcp.supabase.com/mcp (optionally appending ?project_ref=<id>&read_only=true to scope it).
- Save and reload; complete the Supabase sign-in in the browser window that opens to authorize access.
- Verify the Supabase tools appear in Cascade's MCP list, then test with a prompt like "list my tables" to confirm the connection.
Known friction points
- Supabase recommends running the MCP server in read-only mode and scoping it to a single project; granting full write access lets an AI agent execute destructive SQL against your database. [source]
FAQ
- Does Windsurf integrate with Supabase?
- Yes, through Supabase's official MCP server. You add it to Windsurf's mcp_config.json and Cascade can then read and manage your Supabase Postgres database in natural language.
- Do I need a paid plan to connect Windsurf to Supabase?
- No. A Supabase free-tier project works, and any Windsurf plan that supports MCP can add the server. Paid plans only matter for higher usage limits.
- Is the connection read-only or can it change my database?
- By default the MCP server can run writes. Supabase recommends adding read_only=true and a project_ref to the server URL so the AI can only read, and only from one project.
✓ 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
- Supabase docs — Model Context Protocol (MCP) (accessed 2026-06-10)
- windsurf.run — Supabase MCP (mcp_config.json path) (accessed 2026-06-10)