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: Tested with Coolify version 4.0.0-beta.397
Prerequisites
- Node.js 18 or higher
- Coolify Base URL
- Coolify API token
Features
- Teams management (list, get details, members)
- Server management (create, validate, resources, domains)
- Service lifecycle management (start, stop, restart)
- Application lifecycle management (start, stop, restart, execute commands)
- Deployment tracking
- Private key management
- Version and health checks
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
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 container
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
