# Supabase

> Work with Supabase projects through Supabase's official hosted MCP server. Discover the live tool catalog before calling a tool.

- Skill: `am-will/supabase` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add am-will/supabase`
- Raw SKILL.md: https://api.skillmd.com/api/skills/am-will/supabase/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: am-will (https://skillmd.com/u/am-will)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/am-will/supabase

---


# Supabase MCP

Use Supabase's official hosted MCP server from the Prime Agent Python kernel.

## Setup

Configure the `supabase` MCP server and complete `/mcp login supabase` directly
in Prime Agent outside GooeyPi. GooeyPi intentionally does not forward MCP
authentication commands or inspect shared MCP credentials. Prefer a
project-scoped, read-only server URL for routine work.

## Usage

Always discover the server-defined tools and schemas before calling them:

```python
import supabase

tools = await supabase.list_tools()
print([(tool["name"], tool["description"]) for tool in tools])
```

Call a tool by its exact name and pass arguments matching its live input schema:

```python
result = await supabase.call_tool("search_docs", {"graphql_query": "..."})
```

Every operation is async. Supabase MCP may expose database-changing tools unless
the configured URL includes `read_only=true`; review each tool call and do not
connect production data.

Official setup and security guidance:
https://supabase.com/docs/guides/ai-tools/mcp