Coolify MCP Server

The Coolify MCP Server is a model context protocol server integrated with the Coolify API, providing functions such as team management, server management, service lifecycle management, and application deployment.

Developer tools Cloud platform #Server management #Application deployment #Team collaboration Local .TypeScript

rating : 2.5 points

downloads : 18

update time : 2025-04-28

What is the Coolify MCP Server?

The Coolify MCP Server is a middleware service that acts as a bridge between the Coolify platform and MCP tools, allowing users to manage and operate various resources and services in Coolify instances through the standardized MCP protocol.

How to use the Coolify MCP Server?

After installing the Node.js environment, globally install the service via npm or run it directly using npx. Configure the URL and API token of the Coolify instance to start using it.

Applicable scenarios

Suitable for development and operations teams that need to automate the management of Coolify instances, especially for integrating Coolify operations into the CI/CD process or for scenarios where multiple Coolify instances need to be managed uniformly.

Main features

Team managementView the team list, get team details, and manage team members.

Server managementCreate and verify servers, view server resources and domain name configurations.

Service lifecycle managementStart, stop, and restart services.

Application lifecycle managementStart, stop, and restart applications, and execute commands in containers.

Deployment trackingView the deployment list and get deployment details.

Key managementManage SSH private keys.

Advantages and limitations

Advantages

Standardized interface: Provides a unified Coolify management interface through the MCP protocol.

Comprehensive functionality: Covers the main management functions of Coolify.

Easy to integrate: Can be easily integrated into the existing MCP toolchain.

Limitations

Depends on the Node.js runtime environment.

Requires Coolify API access permissions.

Currently only supports the Coolify 4.0.0-beta.397 version.

How to use

Install Node.js

Ensure that Node.js 18 or a higher version is installed on the system.

Install the service

Globally install via npm or run directly using npx.

Get an API token

Create an API token with read, write, and deploy permissions in the 'Keys & Tokens' section of the Coolify console.

Configure environment variables

Set the COOLIFY_BASE_URL and COOLIFY_TOKEN environment variables.

Add to MCP configuration

Add the Coolify server configuration to the MCP settings.

Usage examples

Automated deployment processAutomatically deploy applications to Coolify through MCP commands in the CI/CD process.

Server resource monitoringRegularly check the server resource usage.

Batch restart servicesRestart multiple problematic services simultaneously.

Frequently Asked Questions

How to get an API token?

What should Windows users pay attention to?

What if the service is incompatible with my Coolify version?

How to check if the service is running normally?

Related resources

Coolify official website

The official website and documentation of Coolify

MCP protocol specification

The official specification of the Model Context Protocol

Node.js download

The official Node.js website and download page

🚀 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

Open your Coolify instance.
Navigate to Keys & Tokens / API tokens.
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": []
    }
  }
}