The Coolify MCP Server provides comprehensive management of Coolify deployments with 100% API coverage, offering both MCP integration for AI editors and CLI commands for terminal usage.
Core Capabilities:
Applications (21 operations): Full lifecycle management including listing, creating (6 deployment types: public repos, private GitHub/GitLab, Dockerfile, Docker image, Docker Compose), updating, deleting, and control operations (start, stop, restart, logs). Includes environment variable management (list, create, update bulk/single, delete).
Services (14 operations): Deploy and manage 70+ one-click services (WordPress, Ghost, MinIO, etc.) with full lifecycle control, environment variable management, and service type queries.
Databases (13 operations): Create and manage 8 database types (PostgreSQL, MySQL, MariaDB, MongoDB, Redis, KeyDB, ClickHouse, Dragonfly) with complete lifecycle control.
Projects & Infrastructure: Manage projects (list, create, update, delete) and their environments/resources. Server management includes creation, validation, domain management, and resource monitoring.
Deployments: List all or application-specific deployments, view deployment details, and trigger new deployments with custom parameters.
Private Keys: Full management for secure repository access (list, create, update, delete).
System Administration: Monitor system health and version, enable/disable API access, view system resources, and check configuration status.
Utilities: Connectivity testing (ping) and configuration validation.
Key Features: Identical functionality through both MCP tools and CLI commands, automated API updates to stay current with Coolify.
Supports creating and managing ClickHouse databases within Coolify deployments
Enables one-click deployment and management of Ghost CMS instances through Coolify
Supports application deployment from GitHub repositories via Coolify
Provides tools for creating and managing MariaDB databases in Coolify environments
Enables deployment and management of MinIO object storage services through Coolify
Supports creation and management of MongoDB databases within Coolify deployments
Provides tools for creating and managing MySQL databases in Coolify environments
Enables creation and management of PostgreSQL databases through Coolify
Supports creation and management of Redis databases in Coolify deployments
Enables one-click deployment and management of WordPress instances through Coolify
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Coolify MCP Serverlist my applications and show their current status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
DEPERECATED USE THE SKILL NOW: https://github.com/FelixAllistar/coolify-manager
Coolify MCP Server
A Model Context Protocol (MCP) server for managing Coolify deployments, providing both programmatic MCP tools and comprehensive CLI commands.
Quick Start
Option 1: MCP Integration (Recommended)
MCP (Model Control Protocol) lets you manage Coolify directly from your AI editor.
1. Add to your MCP configuration
For Cursor:
Add to ~/.cursor/mcp.json or <project_folder>/.cursor/mcp.json:
For VS Code:
Add to <project_folder>/.vscode/mcp.json:
🔑 Replace
your-coolify-instance.comwith your actual Coolify URL andyour-coolify-api-tokenwith your API token from Coolify Settings > API.
2. (Cursor only) Enable Coolify MCP
Open Cursor Settings (Ctrl+Shift+J) ➡ Click on MCP tab ➡ Enable coolify-mcp with the toggle
3. Start managing Coolify
In your AI chat, try commands like:
Option 2: CLI Usage
Installation
Configuration
Create a .env file in your project directory:
Common Commands
Related MCP server: Coolify MCP Server
Features
🔄 Applications (21 Operations)
Complete application lifecycle management with 6 deployment types, environment variables, logs, and control operations.
🔧 Services (14 Operations)
70+ one-click services including WordPress, Ghost, MinIO, and more with full environment management.
🗄️ Databases (13 Operations)
8 database types: PostgreSQL, MySQL, MariaDB, MongoDB, Redis, KeyDB, ClickHouse, Dragonfly.
📂 Projects, Servers, Deployments
Complete infrastructure management including private keys, system administration, and deployment monitoring.
MCP Tools vs CLI Commands
This package provides two interaction methods with complete feature parity:
🤖 MCP Tools: For AI agents and Cursor integration (recommended)
💻 CLI Commands: For direct terminal usage
Both interfaces provide identical functionality - choose based on your workflow.
Development
Automated API Updates
Stay in sync with Coolify's latest API:
Manual Development
API Coverage
✅ 100% Coolify API Coverage - Applications, Services, Databases, Projects, Servers, Deployments, Private Keys, System Administration
License
GLWTPL (Good Luck With That Public License) - see LICENSE file for details.
This software might just work or not, there is no third option. Good luck and Godspeed.
MCP Configuration
Option 1: Using npx (Recommended - Simple!)
Option 2: Direct node execution
Option 3: Global installation
Then use the MCP server binary:
CLI Usage
For CLI commands, simply add arguments to the coolify-mcp command: