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
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
# Install globally
npm install -g coolify-mcp-server
# Or use with npx
npx coolify-mcp-server
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 tokens - Create 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:
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": ["-y", "coolify-mcp-server"],
"env": {
"COOLIFY_BASE_URL": "your-coolify-url",
"COOLIFY_TOKEN": "your-api-token"
},
"disabled": false,
"autoApprove": []
}
}
}
Windows Cline users may need the following:
{
"mcpServers": {
"coolify": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"coolify-mcp-server"
],
"env": {
"COOLIFY_BASE_URL": "your-coolify-url",
"COOLIFY_TOKEN": "your-api-token"
},
"disabled": false,
"autoApprove": []
}
}
}
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