The Coolify MCP Server enables comprehensive programmatic management and automation of Coolify instances through the Coolify API, providing control over infrastructure and application lifecycle operations.
System Health & Monitoring: Check Coolify version information, API health status, retrieve application logs, and monitor deployment status and history
Team Management: List teams, get team details, view members, and access current authenticated team context
Project & Environment Organization: Create and list projects to organize resources; create and list environments within projects for different deployment stages (production, staging, development)
Server Infrastructure: Create servers with SSH configuration, list and validate servers, monitor server resources and connectivity, view deployed applications, and manage server domains and proxy settings (Nginx/Caddy)
Application Lifecycle Management: Create applications from Git repositories, start/stop/restart applications, execute commands in running containers, configure exposed ports for external access, and retrieve logs for troubleshooting
Service Management: Create services (MySQL, Redis, PostgreSQL, MongoDB, or custom Docker Compose), start/stop/restart services, list all services, and deploy with custom Docker Compose configurations
Deployment Operations: List all deployments, get detailed deployment information, and track deployment history
Security & Access: Create and manage SSH private keys for server authentication and Git repository access
Enhanced Features: Improved error reporting, UUID format compatibility, and automatic version detection for Coolify 4.0.0-beta.380+
Coolify MCP Server
A Model Context Protocol server that provides integration with the Coolify API. This server enables interaction with Coolify instances through MCP tools.
Compatibility: Supports Coolify version 4.0.0-beta.380+ with automatic version detection and feature compatibility. Tested with versions up to 4.0.0-beta.420.1. API endpoints updated to match official Coolify documentation.
Prerequisites
Node.js 18 or higher
Coolify Base URL
Coolify API token
Related MCP server: MCP Server
Features
Teams management (list, get details, members)
Project management (list, get, create) ✨ NEW
Environment management (list, create within projects) ✨ NEW
Server management (create, validate, resources, domains)
Service lifecycle management (create, start, stop, restart)
Application lifecycle management (create, start, stop, restart, execute commands)
Deployment tracking
Private key management
Version and health checks
Enhanced error reporting with detailed validation messages ✨ IMPROVED
Coolify UUID format compatibility ✨ FIXED
Installation
Configuration
The server requires two environment variables:
COOLIFY_BASE_URL: The base URL of your Coolify instanceCOOLIFY_TOKEN: Your Coolify API token
Getting an API Token
Go to your Coolify instance
Navigate to
Keys & Tokens/API tokensCreate a new token with the following required permissions:
read (for fetching information)
write (for managing resources)
deploy (for deployment operations)
Usage
In MCP Settings
Add the following to your MCP settings configuration:
Windows Cline users may need the following:
Available Tools
Version & Health
get_version: Get Coolify version informationhealth_check: Check Coolify API health status
Teams
list_teams: List all teamsget_team: Get details of a specific teamget_current_team: Get current team detailsget_current_team_members: Get current team members
Servers
list_servers: List all serverscreate_server: Create a new servervalidate_server: Validate server configurationget_server_resources: Get server resource usageget_server_domains: Get server domains
Projects ✨ NEW
list_projects: List all projectsget_project: Get details of a specific projectcreate_project: Create a new project
Environments ✨ NEW
list_environments: List environments in a projectcreate_environment: Create a new environment within a project
Services
list_services: List all servicescreate_service: Create a new servicestart_service: Start a servicestop_service: Stop a servicerestart_service: Restart a service
Applications
list_applications: List all applicationscreate_application: Create a new applicationstart_application: Start an applicationstop_application: Stop an applicationrestart_application: Restart an applicationexecute_command_application: Execute command in application containerget_application_logs: Get application logs for debugging
Deployments
list_deployments: List all deploymentsget_deployment: Get deployment details
Private Keys
list_private_keys: List all private keyscreate_private_key: Create a new private key
License
MIT