# Supabase integration

Toolhouse integrates with Supabase through a dedicated MCP server. Toolhouse makes it easy to configure and use your Supabase server.

This guide assumes you already have a Supabase account and an active project.

## Getting started with Toolhouse and Supabase

{% stepper %}
{% step %}

### Get your Project ID

Go to your Supabase Dashboard.

In Your Organization, select the organization that contains your project. In this case, we're selecting this organization:

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2FzwG3kZZMk0hSva63Nq6s%2FScreenshot%202025-08-02%20at%208.13.04%E2%80%AFAM.png?alt=media&#x26;token=a0855877-3739-4d08-8131-beef1ea3dc79" alt=""><figcaption></figcaption></figure>

Now select the Project you want to connect to Toolhouse. We're going to select this project:

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2Fy0YwqKFMTJb3oRY7ubI4%2FScreenshot%202025-08-02%20at%208.13.52%E2%80%AFAM.png?alt=media&#x26;token=652bdb7b-50ea-4a31-9f83-cbb3048ed299" alt=""><figcaption></figcaption></figure>

In the sidebar, click <i class="fa-gear">:gear:</i> **Project Settings.** You will find the Project ID on this page. Copy the Project ID.
{% endstep %}

{% step %}

### Get your Personal Access Token

Go to your Supabase [**Account Settings**](https://supabase.com/dashboard/account/tokens). Then, click **Generate new token.** Give the token a name, then copy it.
{% endstep %}

{% step %}

### Link Supabase to Toolhouse

Head to our [Toolhouse-Supabase Linker](https://toolhouse-supabase-linker.lovable.app/) and follow the instructions:

1. In the **Supabase Project ID** field, paste the Project ID you obtained from Step 1.
2. In the Personal Access Token field, paste the token you obtained from Step 2.
3. Click **Complete Setup in Toolhouse.**
   {% endstep %}
   {% endstepper %}

Toolhouse will automatically create a new agent that connects to your Supabase project.

{% hint style="info" %}
**Be careful when using MCP**

The Toolhouse - Supabase MCP server is a very powerful tool that gives you and your end users access to your entire Supabase project. If you don't configure your project correctly, you may risk **losing your project and all its data.**

It's important that you carefully review the [**Security risks section from the Supabase docs**](https://supabase.com/docs/guides/getting-started/mcp?ref=toolhouse#security-risks).
{% endhint %}