Coolify

CoolifyMCP is a Model Context Protocol server that gives you programmatic, single-point access to all Coolify features via MCP. You connect using MCP-compatible clients, call actions across systems like projects, applications, databases, servers, and deployments, and integrate Coolify management into your AI workflows with type-safe, production-ready endpoints.

How to use

Connect your MCP client to the available local or remote MCP servers and begin issuing action-based requests. You can manage teams, projects, applications, databases, servers, services, and security keys through consolidated tools. Use the same set of actions across different resources to automate lifecycle tasks, fetch status information, trigger deployments, or retrieve logs. Ensure your MCP client is configured with the appropriate API token and base URL so requests are authenticated and directed to your Coolify instance.

Typical usage patterns include listing teams, creating a project, provisioning a database, starting an application, or triggering a deployment. Each tool provides a consistent set of actions your client can call, such as list, create, get, update, delete, start, stop, restart, and more, all mapped to Coolify functionality. Maintain separate environment variables for security keys and instance URLs, and monitor responses and health indicators to keep your automation reliable.

How to install

Prerequisites: you need Node.js 20+ and npm 9+ (or yarn). You also need a Coolify API token and the base URL for your Coolify instance.

Install and run with npx (no installation needed) and then follow with a start command.

npx coolifymcp

If you prefer to install locally, clone the project, install dependencies, build, and run with environment variables.

git clone https://github.com/howieduhzit/coolifymcp.git
cd coolifymcp
npm install
npm run build

# Run with environment variables
COOLIFY_API_TOKEN="your_token_here" COOLIFY_BASE_URL="https://your-coolify-instance.com/api/v1" npm start

Configuration

Environment variables you need to configure:

{
  "COOLIFY_API_TOKEN": "your_token_here",
  "COOLIFY_BASE_URL": "https://your-coolify-instance.com/api/v1"
}

Environment variables and defaults

Set NODE_ENV to production for production deployments and ensure proper logging, monitoring, and health checks.

Production deployment notes

Health checks are available at the /health endpoint when NODE_ENV is set to production. Make sure to provide a valid COOLIFY_API_TOKEN and correctly set COOLIFY_BASE_URL. Enable logging and monitoring to observe performance and errors in production.

Available tools

coolify_system

System health, version, and information management with actions: health, version, info.

coolify_teams

Team management operations including listing teams, getting the current user, and retrieving members.

coolify_projects

Project CRUD operations including list, create, get, update, and delete.

coolify_project_environments

Manage project environments with list, create, get, delete actions.

coolify_applications

CRUD operations for applications of all types with actions like list, create, update, get, delete; supports multiple source types.

coolify_application_lifecycle

Manage application lifecycle actions such as start, stop, and restart.

coolify_application_envs

Environment variables for applications with list, create, bulk_update, and delete actions.

coolify_logs

Retrieve application logs with the get action.

coolify_application_deployments

Manage deployments for applications with list, get, and trigger actions.

coolify_databases

Database CRUD operations across multiple types with list, create, get, update, delete actions.

coolify_database_lifecycle

Database lifecycle actions like start, stop, restart.

coolify_database_types

Create specific database types such as PostgreSQL, MySQL, MongoDB, Redis.

coolify_servers

Server CRUD operations with list, create, get, update, delete actions.

coolify_server_management

Server operations and resources with validate, domains, and resources actions.

coolify_services

Service CRUD operations with list, create, get, update, delete actions.

coolify_service_lifecycle

Service lifecycle actions: start, stop, restart.

coolify_service_envs

Manage service environment variables with list, create, update, bulk_update, and delete.

coolify_security_keys

Security key management with list, create, get, update, delete actions.