Supabase Coolify Mcp Server
@dj-pearson
The Supabase Coolify MCP Server enables AI agents to fully manage self-hosted Supabase instances on Coolify. It provides 52 production-ready tools for database migrations (with rollback), edge functions, storage, authentication, and health monitoring. Features include Zod-based i
Overview
What is Supabase Coolify MCP Server?
A TypeScript MCP server for managing self-hosted Supabase instances on Coolify. It enables AI agents to deploy database migrations, push edge functions, configure auth and storage, manage Coolify applications, and monitor service health.
How to use Supabase Coolify MCP Server?
Install via npm install -g supabase-coolify-mcp-server or run directly with npx -y supabase-coolify-mcp-server. Configure required environment variables (COOLIFY_API_URL, COOLIFY_API_TOKEN, SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY). Add the server to your MCP client (e.g., Claude Desktop) using the command npx -y supabase-coolify-mcp-server with the env variables.
Key features of Supabase Coolify MCP Server
- Database migration deployment, tracking, rollback, and management
- Edge function deployment, invocation, monitoring, and deletion
- Storage bucket creation, listing, and deletion
- Auth and realtime configuration via tools
- Coolify app lifecycle (list, deploy, start, stop, restart)
- Health checks for Supabase services and Coolify connection
- Zod-based input validation and comprehensive error handling
- One-click Supabase deployment on Coolify
Use cases of Supabase Coolify MCP Server
- Deploy a complete self-hosted Supabase instance on Coolify
- Manage database migrations with safe rollback support
- Push and monitor edge functions for serverless logic
- Configure authentication providers and storage buckets
- Control Coolify applications and access their logs
FAQ from Supabase Coolify MCP Server
What are the prerequisites?
Node.js >= 18.0.0, a Coolify instance (self-hosted or cloud), a Coolify API token, and a self-hosted Supabase instance (or ready to deploy one).
How do I get a Coolify API token?
Log into your Coolify instance, navigate to "Keys & Tokens" > "API tokens", click "Create New Token", select permissions (recommended: *), and copy the generated token.
How do I get a Supabase service role key?
For self-hosted Supabase, go to Settings > API in the Supabase dashboard and copy the service_role key, or retrieve it from environment variables ($SERVICE_ROLE_KEY).
What environment variables are required?
COOLIFY_API_URL, COOLIFY_API_TOKEN, SUPABASE_URL, and SUPABASE_SERVICE_ROLE_KEY. Optional variables include COOLIFY_TEAM_ID, SUPABASE_ANON_KEY, SUPABASE_PROJECT_ID, and direct database connection settings.
Is Node.js required?
Yes, Node.js version 18 or higher is required to run the server.
