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 instance
COOLIFY_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 information
health_check: Check Coolify API health status

Teams

list_teams: List all teams
get_team: Get details of a specific team
get_current_team: Get current team details
get_current_team_members: Get current team members

Servers

list_servers: List all servers
create_server: Create a new server
validate_server: Validate server configuration
get_server_resources: Get server resource usage
get_server_domains: Get server domains

Projects ✨ NEW

list_projects: List all projects
get_project: Get details of a specific project
create_project: Create a new project

Environments ✨ NEW

list_environments: List environments in a project
create_environment: Create a new environment within a project

Services

list_services: List all services
create_service: Create a new service
start_service: Start a service
stop_service: Stop a service
restart_service: Restart a service

Applications

list_applications: List all applications
create_application: Create a new application
start_application: Start an application
stop_application: Stop an application
restart_application: Restart an application
execute_command_application: Execute command in application container
get_application_logs: Get application logs for debugging

Deployments

list_deployments: List all deployments
get_deployment: Get deployment details

Private Keys

list_private_keys: List all private keys
create_private_key: Create a new private key

License

MIT

Coolify