How to integrate Supabase MCP with Atomic Agent

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Supabase.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Supabase account. See the Atomic Agent documentation for installation instructions.

How Atomic Agent connects to Supabase

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Supabase to Atomic Agent

1. Sign up or sign in to the Composio dashboard. Copy your API key.
2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
3. Ask Atomic Agent to do something in Supabase. It searches Composio for the right tool.
4. On first use, open the sign-in link returned in the chat. Connect your Supabase account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

The Supabase MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Supabase account. It provides structured and secure access to your projects, databases, development branches, Edge Functions, storage configuration, and logs, so your agent can manage projects, run SQL and migrations, manage branches, deploy Edge Functions, and investigate logs on your behalf.

• Project and organization management: Have your agent list organizations and projects, inspect project details and costs, create new projects, or pause and restore existing ones.
• Database development: Direct your agent to list tables, extensions, and migrations, execute SQL, apply migrations, and generate TypeScript types from your database schema.
• Branch workflows: Let the agent create, list, rebase, reset, merge, or delete development branches as your database changes move toward production.
• Edge Functions and storage: Instruct your agent to inspect and deploy Edge Functions, list storage buckets, and review or update project storage settings.
• Debugging and guidance: Have your agent query project logs, review advisory notices, and search Supabase documentation when you need help diagnosing an issue.

Use Supabase from Atomic Agent

With your account connected, ask Atomic Agent to work with Supabase in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.