Best for
- Developers and DevOps professionals using Coolify for self-hosted PaaS.
- Teams looking to simplify daily deployment and operations with AI assistants.
- Scenarios involving multiple Coolify instances.
C
Coolify MCP Server
Community
MCP server for managing self-hosted PaaS Coolify with 44 optimized tools.
GitHub source repository ↗
68FMRS · C
Coolify MCP Server is a feature-rich and well-designed MCP server for managing Coolify self-hosted PaaS. It reduces context consumption through tool consolidation and token optimization, while providing secure defaults and human confirmation. Ideal for users who want to simplify operations with AI assistants.
Coolify MCP Server is an MCP server that allows AI assistants like Claude and Cursor to manage a Coolify instance through natural language. It provides 44 consolidated tools covering infrastructure overview, diagnostics, deployments, environment variables, databases, services, backups, scheduled tasks, and more. The design focuses on token efficiency by using action-parameter tools to reduce context usage. It features secure defaults including secret masking and human confirmation for destructive operations. Compatible with Coolify v4.0 through v4.2+.
Tools
get_infrastructure_overview
Get an overview of the entire infrastructure.
get_mcp_version
Get the version of the MCP server itself.
get_version
Get the version of the Coolify instance.
system
System operations like health check, list resources, enable/disable API.
diagnose_app
Diagnose a specific app by UUID, name, or domain.
diagnose_server
Diagnose a specific server by UUID, name, or IP.
find_issues
Find potential issues in the infrastructure.
restart_project_apps
Restart all applications in a project.
bulk_env_update
Bulk update environment variables across apps.
stop_all_apps
Stop all applications (destructive, requires confirmation).
redeploy_project
Redeploy an entire project (destructive, requires confirmation).
list_servers
List all servers.
get_server
Get detailed server information.
validate_server
Validate server configuration.
server_resources
List resources (apps, databases, etc.) on a server.
server_domains
List domains on a server.
projects
Project management: list, get, create, update, delete.
environments
Environment management: list, get, create, delete.
list_applications
List all applications.
get_application
Get detailed application information.
application
Application CRUD operations and delete preview.
list_databases
List all databases.
get_database
Get detailed database information.
database
Database CRUD operations, supporting 8 types and deletion.
database_backups
Database backup management: CRUD schedules, executions including deletion.
list_services
List all services.
get_service
Get detailed service information.
service
Service CRUD operations, container list, update, start/stop/restart (v4.2+).
control
Start/stop/restart apps, databases, services.
logs
Get container logs for app, database, service.
application_logs
Get application logs (superseded by logs).
tags
Tag management: list, attach, detach, and deploy tagged resources.
env_vars
Environment variable CRUD and bulk update for apps, services, databases.
storages
Storage management: list, create, update, delete persistent/file storages.
scheduled_tasks
Scheduled task management: list, create, update, delete, list executions, run once.
list_deployments
List deployment records.
deploy
Trigger deployment, optionally wait for completion and return logs.
deployment
Deployment details, cancel, list per app.
private_keys
Private key management: list, get, create, update, delete.
github_apps
GitHub Apps management: list, get, create, update, delete, list repos and branches.
teams
Team management: list, get members, get current team.
cloud_tokens
Cloud token management (Hetzner/DigitalOcean): list, get, create, update, delete, validate.
hetzner
Hetzner Cloud operations: list locations, server types, images, SSH keys, create server.
search_docs
Full-text search across Coolify docs.
Setup
- Ensure you have a running Coolify v4 instance and an API token (Coolify → Settings → API).
- For Claude Desktop: download coolify-mcp.mcpb and drag into Settings → Extensions, then enter your Coolify URL and token.
- For Claude Code: run
claude mcp add coolify -e COOLIFY_BASE_URL="..." -e COOLIFY_ACCESS_TOKEN="..." -- npx @masonator/coolify-mcp@latest. - For other MCP clients: add an mcpServers entry in JSON config with command npx, args ['-y', '@masonator/coolify-mcp'], and env COOLIFY_BASE_URL and COOLIFY_ACCESS_TOKEN.
- Optional: add --header args for Cloudflare Access or proxy.
claude_desktop_config.json
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": [
"-y",
"@masonator/coolify-mcp"
],
"env": {
"COOLIFY_BASE_URL": "https://your-coolify-instance.com",
"COOLIFY_ACCESS_TOKEN": "your-api-token"
}
}
}
}
Fit and risk
Not for
- Users without a Coolify instance.
- Operations that need fully automated destructive actions without confirmation (though you can disable confirmations with COOLIFY_MCP_ELICITATION=off).
- Deployments to incompatible Coolify versions (only v4.0 and above supported).
Required permissions
- Requires a Coolify API access token (COOLIFY_ACCESS_TOKEN); its permissions determine what operations the MCP can perform.
- Can read and modify resources such as apps, databases, services, and environment variables.
- Destructive operations (e.g., delete, stop) trigger human confirmation unless disabled.
Risks and side effects
- If the API token has excessive permissions, unexpected deletion or stopping of resources could occur.
- Destructive operations may cause data loss, but the confirmation mechanism reduces risk.
- Sensitive information (like passwords and keys) is masked by default, but enabling reveal could pose a leak risk.
Troubleshooting
- Ensure COOLIFY_BASE_URL and COOLIFY_ACCESS_TOKEN are set correctly.
- Check that the Coolify version is v4.0 or above.
- If confirmation prompts time out, increase the client's MCP tool timeout.
- If you receive 403 errors, check that the token has write permissions.
- If reveal: true returns empty values, you may need a token with sensitive-read scope.
Use cases
Manage apps, databases, and services on Coolify via natural language.
Quickly diagnose issues with apps or servers and get recommendations.
Perform batch operations like restarting all apps in a project or stopping all apps.
Manage environment variables, storages, scheduled tasks, and backups.
Search Coolify documentation for help.
Supported clients
Claude DesktopFull support
Claude CodeFull support
CursorFull support