Coolify MCP Server

Manage Coolify infrastructure and deployments through natural language commands.

Data last scanned today · Reviewed today

4842 tools★ 524TypeScriptMIT

Overview

This MCP server provides 42 tools for interacting with a Coolify v4 instance directly from compatible AI clients. It allows users to query system infrastructure, run diagnostics, and manage deployments without leaving their AI workflow.

Our verdict

With a security score of 48/100, this server is currently classified as high risk. The rating reflects that it is community-maintained rather than official and lacks editorial review, specifically regarding its OAuth and authentication methods. It is best suited for developers comfortable managing self-hosted infrastructure who can independently verify the security implications of its API access.

Supports 42 specific Coolify deployment and diagnostic tools
Small footprint with only 3 direct dependencies
Active development with commits within the last 24 hours

High security risk due to unreviewed authentication methods
Lacks official vendor maintenance and editorial security oversight
Read-only capabilities remain unreviewed

Setup

Claude Desktop

{
  "mcpServers": {
    "coolify-mcp": {
      "args": [
        "-y",
        "@masonator/coolify-mcp"
      ],
      "command": "npx"
    }
  }
}

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.

No read-only mode — running this grants full read/write access.
No built-in authentication — anyone with access to this config can invoke every tool it exposes.

Tools

Tool	Description	Risk
get_infrastructure_overview	Get an overview of the infrastructure.	low
get_mcp_version	Get the MCP server version.	low
get_version	Get the Coolify version.	low
system	Perform system operations like health checks, listing resources, or toggling API features.	medium
diagnose_app	Diagnose issues for a specific application.	low
diagnose_server	Diagnose issues for a specific server.	low
find_issues	Identify potential issues across the infrastructure.	low
restart_project_apps	Restart all applications within a project.	medium
bulk_env_update	Perform a bulk update of environment variables.	medium
stop_all_apps	Stop all running applications.	medium

Compatibility

Client	Local	Docker	Remote	Read-only
ChatGPT
Claude Desktop
Cursor
VS Code
Windsurf

Frequently asked questions

›What prerequisites are required to use this MCP server?

You must have a running Coolify v4 instance and a valid API token generated from your Coolify Settings page.

›How can I connect the server if it is behind Cloudflare Access or an auth proxy?

You can provide custom headers by using the --header "Key: Value" argument, which is repeatable for multiple headers.

›Does the Claude Desktop installation require Node.js?

No, the one-click installation method for Claude Desktop via the provided .mcpb file does not require a local Node installation or manual JSON configuration.

›Can I manage multiple Coolify instances with this server?

Yes, the installation guide covers configurations for multiple Coolify instances, as well as specific instructions for proxy setups and Cursor integration.