Coolify MCP Server (Stu Mason)
Coolify infrastructure management through 44 token-optimized natural language tools.
Data last scanned 2 days ago · Reviewed 2 months ago
Overview
This server provides an interface to manage Coolify v4 instances, allowing users to perform deployments, diagnostics, and operational tasks directly from their AI assistant. It supports a wide array of commands categorized into infrastructure management, server diagnostics, and system health monitoring. Installation options include a one-click file for Claude Desktop or a command-line setup for Claude Code and other MCP-compliant clients. The server supports custom headers for instances hidden behind Cloudflare Access or other authentication proxies.
Our verdict
With a security score of 48/100, this server is classified as high-risk. This rating reflects that the project is community-maintained rather than vendor-official and has not undergone an editorial security review, particularly regarding its OAuth and authentication implementations. It is suitable for users comfortable with the inherent risks of connecting third-party tools to their infrastructure, but it should be avoided in high-security environments until full audit status is achieved.
- Includes 44 specialized tools for managing Coolify deployments
- Supports proxy authentication via repeatable custom header arguments
- Maintained by 15 contributors with a very low bus-factor risk
- Small footprint with only 3 direct dependencies
- Security score of 48/100 indicates high risk level
- Authentication and OAuth mechanisms remain unreviewed
- Community-maintained project lacking official Coolify vendor support
Setup
{
"mcpServers": {
"stumason-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.
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›What prerequisites are required to use this MCP server?
You need a running Coolify v4 instance and an API token, which can be generated in your Coolify settings under the API section.
›How can I install the server in Claude Desktop?
You can use the one-click installation by downloading the .mcpb file from the releases page and dragging it into your Claude Desktop Settings under the Extensions tab.
›Can I use this server if my Coolify instance is behind a proxy or Cloudflare Access?
Yes, you can include custom headers by adding --header "Key: Value" arguments to your MCP server configuration.
›Is it possible to manage multiple Coolify instances?
Yes, you can repeat the server configuration in your MCP client settings to connect to multiple separate Coolify instances.
›What specific versions of Coolify are supported?
The server is designed for Coolify v4. Some advanced features, such as specific service controls and tag management, require Coolify v4.2 or higher.
Alternatives
Badge
Maintain this server? Add the live badge to your README.