coolify-mcp
MCP server for managing Coolify instances. Control applications, databases, services, servers, and more directly from Claude or any MCP-compatible client.
74 tools | 7 resources | 4 prompts
Installation
Claude Code
claude mcp add coolify \
-e COOLIFY_API_URL=http://your-server:8000/api/v1 \
-e COOLIFY_TOKEN=your-token \
-- npx coolify-mcpCodex
codex mcp add coolify \
--env COOLIFY_API_URL=http://your-server:8000/api/v1 \
--env COOLIFY_TOKEN=your-token \
-- npx coolify-mcpOther MCP clients
COOLIFY_API_URL=http://your-server:8000/api/v1 \
COOLIFY_TOKEN=your-token \
npx coolify-mcpFrom source
git clone https://github.com/0xtlt/coolify-mcp
cd coolify-mcp && bun install
COOLIFY_API_URL=... COOLIFY_TOKEN=... bun run src/index.tsClaude Desktop
Add to ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"coolify": {
"command": "bun",
"args": ["run", "/path/to/coolify-mcp/src/index.ts"],
"env": {
"COOLIFY_API_URL": "http://your-server:8000/api/v1",
"COOLIFY_TOKEN": "your-token"
}
}
}
}Get your API token
Coolify dashboard: Keys & Tokens > API tokens
Available Tools
Applications (8)
| Tool | Description | |------|-------------| | coolify_list_applications | List all applications (summary) | | coolify_get_application | Get application details | | coolify_create_application | [WRITE] Create from public/private repo, Dockerfile, or Docker image | | coolify_update_application | [WRITE] Update application config | | coolify_start_application | [WRITE] Start a stopped application | | coolify_stop_application | [DESTRUCTIVE] Stop an application | | coolify_restart_application | [DESTRUCTIVE] Restart an application | | coolify_delete_application | [DESTRUCTIVE] Delete an application |
Databases (11)
| Tool | Description | |------|-------------| | coolify_list_databases | List all databases (summary) | | coolify_get_database | Get database details | | coolify_create_database | [WRITE] Create PostgreSQL, MySQL, MariaDB, MongoDB, Redis, etc. | | coolify_update_database | [WRITE] Update database config | | coolify_list_database_backups | List backups for a database | | coolify_create_database_backup | [WRITE] Create a database backup | | coolify_delete_database_backup | [DESTRUCTIVE] Delete a scheduled backup config | | coolify_start_database | [WRITE] Start a stopped database | | coolify_stop_database | [DESTRUCTIVE] Stop a database | | coolify_restart_database | [DESTRUCTIVE] Restart a database | | coolify_delete_database | [DESTRUCTIVE] Delete a database |
Services (8)
| Tool | Description | |------|-------------| | coolify_list_services | List all services (summary) | | coolify_get_service | Get service details | | coolify_create_service | [WRITE] Create a one-click Docker Compose service | | coolify_update_service | [WRITE] Update service config | | coolify_start_service | [WRITE] Start a stopped service | | coolify_stop_service | [DESTRUCTIVE] Stop a service | | coolify_restart_service | [DESTRUCTIVE] Restart a service | | coolify_delete_service | [DESTRUCTIVE] Delete a service |
Servers (8)
| Tool | Description | |------|-------------| | coolify_list_servers | List all servers (summary) | | coolify_get_server | Get server details | | coolify_create_server | [WRITE] Add a new server (requires SSH key) | | coolify_update_server | [WRITE] Update server config | | coolify_validate_server | Check SSH connectivity and Docker | | coolify_get_server_resources | List all resources on a server | | coolify_get_server_domains | List all domains on a server | | coolify_delete_server | [DESTRUCTIVE] Delete a server |
Private Keys (5)
| Tool | Description | |------|-------------| | coolify_list_private_keys | List all SSH private keys (summary) | | coolify_get_private_key | Get private key details | | coolify_create_private_key | [WRITE] Create a new SSH key | | coolify_update_private_key | [WRITE] Update an SSH key | | coolify_delete_private_key | [DESTRUCTIVE] Delete an SSH key |
Projects & Environments (9)
| Tool | Description | |------|-------------| | coolify_list_projects | List all projects (summary) | | coolify_get_project | Get project details | | coolify_create_project | [WRITE] Create a new project | | coolify_update_project | [WRITE] Update a project | | coolify_delete_project | [DESTRUCTIVE] Delete a project | | coolify_list_environments | List environments in a project | | coolify_get_environment | Get environment details | | coolify_create_environment | [WRITE] Create an environment | | coolify_delete_environment | [DESTRUCTIVE] Delete an environment |
Deployments (5)
| Tool | Description | |------|-------------| | coolify_list_deployments | List currently running/queued deployments | | coolify_list_application_deployments | List deployment history for an application (with pagination) | | coolify_get_deployment | Get deployment details | | coolify_trigger_deploy | [WRITE] Trigger a deployment | | coolify_cancel_deployment | [WRITE] Cancel a running deployment |
Application Env Vars (4)
| Tool | Description | |------|-------------| | coolify_list_envs | List env vars for an application | | coolify_create_env | [WRITE] Create an env var | | coolify_update_envs_bulk | [WRITE] Bulk update env vars | | coolify_delete_env | [DESTRUCTIVE] Delete an env var |
Service Env Vars (4)
| Tool | Description | |------|-------------| | coolify_list_service_envs | List env vars for a service | | coolify_create_service_env | [WRITE] Create a service env var | | coolify_update_service_envs_bulk | [WRITE] Bulk update service env vars | | coolify_delete_service_env | [DESTRUCTIVE] Delete a service env var |
Database Env Vars (4)
| Tool | Description | |------|-------------| | coolify_list_database_envs | List env vars for a database | | coolify_create_database_env | [WRITE] Create a database env var | | coolify_update_database_envs_bulk | [WRITE] Bulk update database env vars | | coolify_delete_database_env | [DESTRUCTIVE] Delete a database env var |
Logs (3)
| Tool | Description | |------|-------------| | coolify_get_logs | Get application logs with filtering | | coolify_get_database_logs | Get database logs with filtering | | coolify_get_service_logs | Get service logs with filtering |
System (2)
| Tool | Description | |------|-------------| | coolify_get_version | Get Coolify instance version | | coolify_healthcheck | Check if Coolify is healthy |
Teams (3)
| Tool | Description | |------|-------------| | coolify_list_teams | List all teams | | coolify_get_current_team | Get current authenticated team | | coolify_get_team_members | List members of a team |
Available Resources
| URI | Description | |-----|-------------| | coolify://applications | List of all applications | | coolify://databases | List of all databases | | coolify://services | List of all services | | coolify://servers | List of all servers | | coolify://deployments | List of all deployments | | coolify://projects | List of all projects | | coolify://private-keys | List of all SSH private keys |
Available Prompts
| Prompt | Description | |--------|-------------| | troubleshoot_deployment | Step-by-step guide to debug a failed deployment | | infrastructure_overview | Get a complete overview of all infrastructure | | deploy_application | Guided workflow to deploy an application | | setup_new_application | Guided workflow to create and configure a new app |
Safety Modes
| Variable | Description | |----------|-------------| | COOLIFY_READONLY=true | Only read operations available (list, get, logs) | | COOLIFY_REQUIRE_CONFIRM=true | Destructive operations require confirm: true |
Log Filtering
The coolify_get_logs, coolify_get_database_logs, and coolify_get_service_logs tools support:
level: Minimum log level (debug, info, warn, error, fatal)since/until: ISO 8601 timestamps for time rangesearch: Case-insensitive text searchlimit: Max entries (default 100)tail: Get most recent logs
Environment Variables
| Variable | Required | Description | |----------|----------|-------------| | COOLIFY_API_URL | Yes | Coolify API URL (e.g. http://your-server:8000/api/v1) | | COOLIFY_TOKEN | Yes | Bearer token from Coolify dashboard | | COOLIFY_TIMEOUT | No | Request timeout in ms (default: 30000) | | COOLIFY_READONLY | No | Read-only mode (default: false) | | COOLIFY_REQUIRE_CONFIRM | No | Require confirmation for destructive ops (default: false) | | DEBUG | No | Enable debug logging (default: false) |
Development
bun install # Install dependencies
bun run dev # Watch mode
bun run inspect # MCP Inspector
bun run check # Lint + typecheck + test
bun test # Run tests onlyLicense
MIT
