Coolify MCP Server

A Model Context Protocol (MCP) server providing full coverage of the Coolify v4.1.1 REST API. Manage applications, databases, services, servers, deployments, and more — all from any MCP-compatible AI client.

Compatibility: Coolify v4.1.1+ (stable, non-beta). API base: https://<your-coolify-instance>/api/v1

Prerequisites

• Node.js 18 or higher
• A running Coolify v4.1.1+ instance
• A Coolify API token (from Security → API Tokens in the dashboard)

Installation

# Install globally
npm install -g coolify-mcp-server

# Or use with npx (no install needed)
npx coolify-mcp-server

Configuration

Set two environment variables:

| Variable | Description | |---|---| | COOLIFY_BASE_URL | Base URL of your Coolify instance (e.g. https://coolify.example.com) | | COOLIFY_TOKEN | Your Coolify API Bearer token |

MCP Settings (Claude Desktop / Windsurf / Cline)

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

Windows users (Cline/cmd):

{
  "mcpServers": {
    "coolify": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

General

• get_version — Get Coolify version
• health_check — API health check (no auth)
• enable_api / disable_api — Enable/disable the API (root token)
• enable_mcp / disable_mcp — Enable/disable built-in MCP endpoint (root token)

Teams

• list_teams, get_team, get_team_members
• get_current_team, get_current_team_members

Servers

• list_servers, get_server, create_server, update_server, delete_server
• validate_server, get_server_resources, get_server_domains
• create_hetzner_server

Projects

• list_projects, get_project, create_project, update_project, delete_project

Environments

• list_environments, get_environment, create_environment, delete_environment

Applications

• list_applications, get_application
• create_public_application, create_private_github_app_application, create_private_deploy_key_application
• create_dockerfile_application, create_dockerimage_application, create_dockercompose_application
• update_application, delete_application
• start_application, stop_application, restart_application
• get_application_logs
• list_application_envs, create_application_env, update_application_env, bulk_update_application_envs, delete_application_env
• list_application_storages, create_application_storage, delete_application_storage
• list_application_scheduled_tasks, create_application_scheduled_task, delete_application_scheduled_task

Databases

• list_databases, get_database, update_database, delete_database
• create_postgresql_database, create_mysql_database, create_mariadb_database, create_mongodb_database
• create_redis_database, create_keydb_database, create_dragonfly_database, create_clickhouse_database
• start_database, stop_database, restart_database
• get_database_backups, create_database_backup, list_database_backup_executions
• list_database_envs, create_database_env, delete_database_env

Services

• list_services, get_service, create_service, update_service, delete_service
• start_service, stop_service, restart_service
• list_service_envs, create_service_env, delete_service_env
• list_service_scheduled_tasks, create_service_scheduled_task, delete_service_scheduled_task

Deployments

• list_deployments, get_deployment, cancel_deployment
• list_deployments_by_application, deploy_by_tag_or_uuid

Private Keys

• list_private_keys, get_private_key, create_private_key, update_private_key, delete_private_key

GitHub Apps

• list_github_apps, create_github_app, delete_github_app, list_github_app_repositories

Cloud Tokens

• list_cloud_tokens, create_cloud_token, delete_cloud_token

Hetzner

• get_hetzner_locations, get_hetzner_server_types, get_hetzner_images, get_hetzner_ssh_keys
• create_hetzner_server

Resources

• list_resources — All resources across the instance

License

MIT