Coolify MCP Server

🚀 Coolify MCP Server

A Model Context Protocol (MCP) server that integrates with the Coolify API. This server enables interaction with Coolify instances via MCP tools.

⚠️ Important Note

This server is tested to be compatible with Coolify version 4.0.0-beta.397.

🚀 Quick Start

Prerequisites

• Node.js 18 or higher
• Coolify base URL
• Coolify API token

✨ Features

• Team 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 npx
npx coolify-mcp-server

📚 Documentation

Configuration

This server requires two environment variables:

• COOLIFY_BASE_URL: The base URL of your Coolify instance
• COOLIFY_TOKEN: Your Coolify API token

Obtaining an API Token

1. Open your Coolify instance.
2. Navigate to Keys & Tokens / API tokens.
3. Create a new token with the following permissions:
   • read (for retrieving information)
   • write (for managing resources)
   • deploy (for deployment operations)

💻 Usage Examples

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 command-line users may need the following configuration:

{
  "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 and Health

• get_version: Get Coolify version information
• health_check: Check the health status of the Coolify API

Teams

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

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

Services

• list_services: List all services
• get_service: Get details of a specific service
• start_service: Start a service
• stop_service: Stop a service
• restart_service: Restart a service

Applications

• list_applications: List all applications
• get_application: Get details of a specific application
• start_application: Start an application
• stop_application: Stop an application
• restart_application: Restart an application
• execute_command: Execute a command

Deployments

• list_deployments: List all deployments
• get_deployment: Get details of a specific deployment
• deploy_application: Deploy an application
• undeploy_application: Undeploy an application

📄 License

MIT