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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that provides integration with the Coolify API, enabling DevOps teams to manage Coolify deployments, applications, services, and servers through MCP tools.

Related MCP Servers

MCP Server
la-rebelion
-
security
A
license
-
quality
MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
Last updated -
1
4
TypeScript
MIT License
MCP Server
agentico-dev
-
security
A
license
-
quality
MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
Last updated -
17
3
TypeScript
MIT License
Coolify MCP Server
StuMason
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to interact with Coolify instances through natural language, allowing management of servers, applications, databases, and deployments.
Last updated -
631
38
TypeScript
Coolify MCP Server
pavelsukhachev
-
security
A
license
-
quality
An MCP server that enables AI assistants to manage infrastructure, applications, databases, and services through the Coolify PaaS platform.
Last updated -
4
1
TypeScript
MIT License

View all related MCP servers

Coolify MCP Server