{
 "kind": "mcp",
 "slug": "com-supabase-mcp",
 "path": "mcp/servers/com-supabase-mcp/",
 "name": "Supabase",
 "maker": "supabase",
 "density": "full",
 "crumbs": [
  [
   "MCP servers",
   "mcp/"
  ],
  [
   "Databases",
   "mcp/databases/"
  ]
 ],
 "lead": "your AI assistant works in your Supabase projects.",
 "chips": [
  {
   "label": "Databases",
   "path": "mcp/databases/"
  },
  {
   "label": "Official"
  },
  {
   "label": "Remote"
  }
 ],
 "primary": {
  "label": "Copy connect command",
  "copy": "claude mcp add --scope project --transport http supabase \"https://mcp.supabase.com/mcp\""
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/supabase/mcp"
  },
  {
   "label": "Website",
   "href": "https://supabase.com/mcp"
  }
 ],
 "track": "New versions and outages of the remote endpoint on your dashboard",
 "verdicts": [
  {
   "key": "official",
   "label": "Made by",
   "value": "The service itself",
   "status": "yes",
   "sub": "Official server",
   "quote": "The MCP server repository is available at github.com/supabase/mcp.",
   "note": "The repository belongs to the supabase organization and Supabase's own docs at supabase.com name it as the server's repository; the server wraps Supabase's own platform.",
   "src": "https://supabase.com/docs/guides/ai-tools/mcp.md"
  },
  {
   "key": "secrets",
   "label": "Keys",
   "value": "1 secret needed",
   "status": "info",
   "sub": "SUPABASE_ACCESS_TOKEN (only for CI or the local npm package;",
   "quote": "Add the MCP server to your project config using the command line",
   "note": "Local development with the Supabase CLI uses http://localhost:54321/mcp, with fewer tools and no browser sign-in.",
   "src": "https://supabase.com/docs/guides/ai-tools/mcp.md"
  },
  {
   "key": "where",
   "label": "Runs",
   "value": "Remote or local",
   "status": "info",
   "sub": "Hosted URL, or run the package yourself",
   "note": "Endpoint: https://mcp.supabase.com/mcp. Checked: yes: one unauthenticated GET to https://mcp.supabase.com/mcp answered 401 (sign-in required) on 2026-11-10.",
   "src": "https://mcp.supabase.com/mcp"
  },
  {
   "key": "license",
   "label": "Commercial use",
   "value": "Allowed",
   "status": "yes",
   "sub": "Apache-2.0 license",
   "quote": "This project is licensed under Apache 2.0.",
   "note": "The server code is Apache 2.0; using it for paid work is allowed, Supabase usage is billed as usual.",
   "src": "https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/README.md"
  }
 ],
 "vfoot": "Checked against its repository at one commit, on Nov 10, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What Supabase does",
   "parts": [
    {
     "t": "prose",
     "text": "The official Supabase connector lets an AI assistant such as Claude Code, Codex or Cursor work inside your Supabase projects. It can list your tables, run database queries, change the schema, read logs and deploy server functions for you. You sign in through the browser, so there is no key to paste."
    },
    {
     "t": "h3",
     "text": "What people use it for"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "Ask about your database in words",
       "text": "Ask your assistant which tables you have or what a row looks like, and it reads them from your project instead of guessing from old code.",
       "idea": false
      },
      {
       "title": "A safe look at a live project",
       "text": "Limit the connection to one project and to reading only, so the assistant can check real data without changing it.",
       "idea": false
      },
      {
       "title": "Change tables with tracked migrations",
       "text": "When you ask for a new column or table, the assistant writes the change as a migration, so it is saved in the project's migration history.",
       "idea": false
      },
      {
       "title": "Find out why something broke",
       "text": "The assistant reads the project's logs and Supabase's security and performance notices before it suggests a fix, such as a table left without access rules.",
       "idea": false
      },
      {
       "title": "Wire up the app's front end",
       "text": "The assistant fetches the project address, the public keys and ready TypeScript types, so your app talks to the right project with correct field names.",
       "idea": false
      },
      {
       "title": "Check from a nightly job without a browser",
       "text": "In an automated job there is no one to sign in, so give the connection a scoped access token from an environment variable instead.",
       "idea": false
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "Supabase popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "3,018",
       "l": "GitHub stars, supabase/mcp"
      },
      {
       "n": "213K",
       "l": "downloads last week, @supabase/mcp-server-supabase"
      },
      {
       "n": "339",
       "l": "public agent projects connect it"
      }
     ]
    },
    {
     "t": "list",
     "items": [
      "your-digital-rights/yourdigitalrights.org",
      "spacehendrix/clauder",
      "TeemuSo/saas-template-for-ai-lite",
      "tdimino/claude-code-minoan"
     ]
    }
   ]
  },
  {
   "id": "tools",
   "nav": "Tools",
   "h2": "Tools it gives your agent (41)",
   "parts": [
    {
     "t": "tools",
     "items": [
      {
       "name": "search_docs",
       "text": "Searches the Supabase documentation."
      },
      {
       "name": "list_organizations",
       "text": "Lists the organizations you belong to."
      },
      {
       "name": "get_organization",
       "text": "Shows one organization, including its plan."
      },
      {
       "name": "list_projects",
       "text": "Lists your Supabase projects."
      },
      {
       "name": "get_project",
       "text": "Shows one project's details and status."
      },
      {
       "name": "get_cost",
       "text": "Quotes the cost of a new project or branch (older confirmation flow)."
      },
      {
       "name": "confirm_cost",
       "text": "Returns a confirmation id after you agree to that cost (older confirmation flow)."
      },
      {
       "name": "create_project",
       "text": "Creates a new project; this can add to your bill."
      },
      {
       "name": "pause_project",
       "text": "Pauses a project."
      },
      {
       "name": "restore_project",
       "text": "Restores a paused project."
      },
      {
       "name": "list_tables",
       "text": "Lists the tables, optionally with columns and keys."
      },
      {
       "name": "list_extensions",
       "text": "Lists the database extensions."
      },
      {
       "name": "list_migrations",
       "text": "Lists the migrations already applied."
      },
      {
       "name": "apply_migration",
       "text": "Applies a schema change as a saved migration (writes)."
      },
      {
       "name": "execute_sql",
       "text": "Runs any SQL in the database; can read, change or delete data."
      },
      {
       "name": "get_logs",
       "text": "Gets a service's logs for up to 24 hours; hidden where query_logs is offered."
      },
      {
       "name": "query_logs",
       "text": "Runs a read-only SQL query over the project's logs."
      },
      {
       "name": "get_advisors",
       "text": "Lists security, performance and health notices for the project."
      },
      {
       "name": "get_project_url",
       "text": "Gets the project's address for app code."
      },
      {
       "name": "get_publishable_keys",
       "text": "Gets the public keys your app may ship."
      },
      {
       "name": "generate_typescript_types",
       "text": "Generates TypeScript types from the schema."
      },
      {
       "name": "list_edge_functions",
       "text": "Lists the project's server functions."
      },
      {
       "name": "get_edge_function",
       "text": "Reads one server function's files."
      },
      {
       "name": "deploy_edge_function",
       "text": "Deploys or replaces a server function; it goes live at once."
      },
      {
       "name": "create_edge_function_secret",
       "text": "Asks you to type a function secret in the Supabase dashboard; the value never passes through the assistant."
      },
      {
       "name": "create_branch",
       "text": "Creates a development branch of the database; costs money by the hour (paid plans)."
      },
      {
       "name": "list_branches",
       "text": "Lists development branches and their status."
      },
      {
       "name": "delete_branch",
       "text": "Deletes a development branch."
      },
      {
       "name": "merge_branch",
       "text": "Merges a branch's migrations and functions into production."
      },
      {
       "name": "reset_branch",
       "text": "Resets a branch's migrations; untracked changes are lost."
      },
      {
       "name": "rebase_branch",
       "text": "Runs newer production migrations on a branch."
      },
      {
       "name": "submit_feedback",
       "text": "Sends feedback to the Supabase team."
      },
      {
       "name": "delete_feedback",
       "text": "Deletes feedback sent earlier."
      },
      {
       "name": "list_storage_buckets",
       "text": "Lists file storage buckets (storage group, off by default)."
      },
      {
       "name": "get_storage_config",
       "text": "Reads the storage settings (off by default)."
      },
      {
       "name": "update_storage_config",
       "text": "Changes the storage settings (off by default)."
      },
      {
       "name": "list_notebooks",
       "text": "Lists saved notebooks of the project (hosted only)."
      },
      {
       "name": "get_notebook",
       "text": "Reads one notebook and its cells."
      },
      {
       "name": "create_notebook",
       "text": "Saves a notebook shared with everyone on the project."
      },
      {
       "name": "run_notebook",
       "text": "Runs up to 50 query cells of a notebook."
      },
      {
       "name": "delete_notebook",
       "text": "Deletes a notebook for everyone; cannot be undone."
      }
     ]
    }
   ]
  },
  {
   "id": "data",
   "nav": "Data and license",
   "h2": "What it sends and its license",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Sends",
       "v": "every tool call and its results, including rows from your database",
       "sub": "To Supabase (mcp.supabase.com) and then the AI model your client uses; on each tool call. Opt out: scope to one project, use read_only=true and features=... to limit what can be read."
      },
      {
       "l": "Sends",
       "v": "feedback text about Supabase tools",
       "sub": "To the Supabase team; only when submit_feedback is called; the tool tells the agent to ask you first. Opt out: disable the feedback group with features=..., or use read_only=true."
      }
     ]
    },
    {
     "t": "prose",
     "text": "The server's code is free under the Apache 2.0 license, also for paid work. Using it costs nothing by itself, but what it creates in your Supabase account is billed as usual."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "Yes",
       "status": "yes",
       "sub": "The server code is Apache 2.0; using it for paid work is allowed, Supabase usage is billed as usual.",
       "quote": "This project is licensed under Apache 2.0.",
       "src": "https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/README.md"
      },
      {
       "l": "client-work",
       "v": "With conditions",
       "status": "cond",
       "sub": "Fine for building a client's app, but use it as a developer tool; do not give it to the client's end users.",
       "quote": "Instead, use it internally as a developer tool to help you build and test your applications.",
       "src": "https://supabase.com/docs/guides/ai-tools/mcp.md"
      },
      {
       "l": "Pass on its files",
       "v": "With conditions",
       "status": "cond",
       "sub": "You may pass on or change the code under Apache 2.0, keeping its license notice.",
       "quote": "This project is licensed under Apache 2.0. See the LICENSE file for details.",
       "src": "https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/README.md"
      }
     ]
    }
   ]
  },
  {
   "id": "alive",
   "nav": null,
   "spy_as": "data",
   "h2": "Is it alive",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Latest version",
       "v": "0.19.0 in the registry, updated Nov 20, 2026"
      },
      {
       "l": "Last release",
       "v": "0.16.1 (2026-11-06)"
      },
      {
       "l": "Remote endpoint",
       "v": "yes: one unauthenticated GET to https://mcp.supabase.com/mcp answered 401 (sign-in required) on 2026-11-10",
       "status": "yes"
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "Supabase",
       "me": true,
       "facts": [
        "3,018 stars",
        "Remote"
       ]
      },
      {
       "name": "DBHub",
       "why": "Pick it if your database is MySQL, SQL Server, SQLite or PostgreSQL outside Supabase",
       "path": "mcp/servers/io-github-bytebase-dbhub/",
       "facts": [
        "3,870 stars",
        "Local",
        "in 23 projects"
       ]
      },
      {
       "name": "MCP Toolbox for Databases",
       "why": "Pick it if you want one connector setup for many database types",
       "path": "mcp/servers/io-github-googleapis-genai-toolbox/",
       "facts": [
        "16.9K stars",
        "Local"
       ]
      },
      {
       "name": "supabase-mcp-server-supabase",
       "why": "Pick it if you need the same Supabase tools run on your own machine with a token, not the hosted address",
       "path": null,
       "facts": [
        "Local"
       ]
      }
     ],
     "more": "All databases servers",
     "more_path": "mcp/databases/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "Connect the Supabase MCP server at https://mcp.supabase.com/mcp scoped to my project with read_only=true, list the tables and the security advisors, and ask me before any migration or write query."
    },
    {
     "t": "h3",
     "text": "Connect it"
    },
    {
     "t": "tabs",
     "label": "Connect by client",
     "items": [
      {
       "tab": "Claude Code",
       "code": "claude mcp add --scope project --transport http supabase \"https://mcp.supabase.com/mcp\""
      },
      {
       "tab": "npm (stdio)",
       "code": "npx -y @supabase/mcp-server-supabase"
      },
      {
       "tab": "Cursor",
       "code": "{\n  \"mcpServers\": {\n    \"supabase\": {\n      \"url\": \"https://mcp.supabase.com/mcp\"\n    }\n  }\n}\n"
      },
      {
       "tab": "Any client (JSON)",
       "code": "{\n  \"mcpServers\": {\n    \"supabase\": {\n      \"url\": \"https://mcp.supabase.com/mcp\"\n    }\n  }\n}"
      }
     ]
    },
    {
     "t": "small",
     "text": "Local development with the Supabase CLI uses http://localhost:54321/mcp, with fewer tools and no browser sign-in."
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "Connecting the plain https://mcp.supabase.com/mcp address to a production project for a quick look",
       "fix": "Add ?project_ref=<id>&read_only=true (and features=database,docs if that is all you need)",
       "why": "Without them the assistant sees every project you can reach and may run write queries."
      },
      {
       "dont": "Creating or altering tables with execute_sql",
       "fix": "Use apply_migration for schema changes, execute_sql for queries",
       "why": "The server's own tool text sends schema changes to apply_migration, which records them as migrations."
      },
      {
       "dont": "Adding skip_elicitations=create_project,create_branch to avoid the cost dialog and charges",
       "fix": "Keep the confirmations; skipping them only falls back to quoting the cost in chat",
       "why": "Skipping a form changes how the cost is confirmed, not what you pay."
      },
      {
       "dont": "Pasting an edge function secret value into the chat",
       "fix": "Let create_edge_function_secret open the Supabase dashboard and type the value there",
       "why": "The tool asks only for the secret's name and project; the value belongs in the dashboard."
      },
      {
       "dont": "Following instructions that appear inside query results or notebook cells",
       "fix": "Treat table contents as data and review the next tool call yourself",
       "why": "Stored user text can carry prompt injection that tries to run other queries."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Do I need an API key?",
       "a": "No for the hosted server. Your assistant opens a browser window where you sign in to Supabase. A personal access token is only needed for CI jobs or clients that cannot do the browser sign-in.",
       "evidence": {
        "url": "https://supabase.com/docs/guides/ai-tools/mcp.md",
        "quote": "This means that you don't need to manually create a personal access token (PAT) or OAuth app to use the server."
       }
      },
      {
       "q": "Can it delete my data?",
       "a": "It can run any SQL unless you set read_only=true. With a client that supports forms it asks you before statements it sees as destructive, but that check is a guardrail, not a guarantee.",
       "evidence": {
        "url": "https://supabase.com/docs/guides/ai-tools/mcp.md",
        "quote": "Treat this elicitation as a guardrail - it may not catch every destructive operation and is not a security guarantee."
       }
      },
      {
       "q": "Can it create things that cost money?",
       "a": "Yes, create_project and create_branch. It shows the cost and waits for your yes when your client supports forms, otherwise the assistant quotes the cost in chat first.",
       "evidence": {
        "url": "https://supabase.com/docs/guides/ai-tools/mcp.md",
        "quote": "Cost confirmation applies to create_project and create_branch."
       }
      },
      {
       "q": "Does it work with a local Supabase?",
       "a": "Yes. The Supabase CLI serves it at http://localhost:54321/mcp, with fewer tools and no browser sign-in.",
       "evidence": {
        "url": "https://github.com/supabase/mcp/blob/8a08e48de4af80d26bf5d64dc812e865083eb6ff/README.md",
        "quote": "If you're running Supabase locally with Supabase CLI, you can access the MCP server at http://localhost:54321/mcp."
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Registry name",
   "com.supabase/mcp"
  ],
  [
   "Category",
   "Databases"
  ],
  [
   "Version",
   "0.19.0"
  ],
  [
   "Remote endpoint",
   "https://mcp.supabase.com/mcp"
  ],
  [
   "Package",
   "npm @supabase/mcp-server-supabase"
  ],
  [
   "License",
   "Apache-2.0"
  ],
  [
   "GitHub",
   "supabase/mcp"
  ],
  [
   "In the registry since",
   "Nov 20, 2026"
  ],
  [
   "Works with",
   "Claude Code, OpenAI Codex, OpenCode, LangChain, n8n, LangGraph"
  ]
 ],
 "good": [
  "It can write and delete. Raw queries and migrations change your real database unless you turn on reading only.",
  "Text stored in your tables can carry hidden orders for the assistant. Keep approving each tool call by hand.",
  "It acts with your developer rights, so it is a tool for you and your team, not something to hand to your app's users."
 ],
 "checked_line": "Read by AgentGid from 15 pages and files at one commit, checked Nov 10, 2026; stars update daily.",
 "logo": "https://agentgid.com/media/avatars/supabase.png"
}