Ask Claude Code to write a query against your Supabase database and it guesses: column names from the variable names in your code, a user_id that’s actually owner_id , a migration that collides with one you already ran. It can’t see the schema, so you end up pasting table definitions into the chat.
Supabase MCP is Supabase’s official server. It lets Claude Code list your tables, run SQL, read logs, check security advisors, and generate TypeScript types straight from the real database. It’s hosted, signs in with OAuth, and this guide sets it up read-only and scoped to one project by default, which is how Supabase recommends starting.
What the full guide covers:
- What You’ll Need
- Step-by-Step Setup
- What Each Piece Does
- Verify It’s Actually Working
The commands, our own test notes, and the troubleshooting steps are in the full guide, which we keep up to date:
Top comments (0)