coolify

This MCP server provides a bridge to the Coolify API, enabling you to manage resources such as applications, databases, servers, projects, services, teams, deployments, and private keys directly from MCP-compatible assistants like Claude, Kiro, or custom clients. Once running, you can issue MCP commands to list, get, create, update, deploy, or execute actions against Coolify resources, with the ability to generate resource URIs using coolify:// for direct access. The server includes version detection to ensure compatibility with your Coolify version and built-in rate limiting with retry logic to handle transient API limits.

Key capabilities exposed by this MCP server include: retrieving Coolify version and health status; listing and inspecting teams, servers, projects, environments, and applications; creating and updating servers and applications; performing deployments and execution of commands within containers; and obtaining logs and resource usage. It also supports safety features such as read-only mode to prevent write operations and a confirmation flag for dangerous operations, helping minimize accidental changes. Typical workflows involve configuring your MCP client with the necessary environment variables (base URL and API token), then issuing tool commands like get_server, list_applications, deploy_application, or execute_command, depending on your needs.

Prerequisites:

• Node.js and npm installed on your machine
• Access to a Coolify instance with an API token
• Internet access to install dependencies

Install from npm (recommended):

npm install -g coolify-mcp-server-kof70

Run the interactive setup (via MCP server usage):

npx coolify-mcp-server-kof70 --setup

This will prompt you for your Coolify URL and API token, validate the connection, and optionally configure IDE integrations (Kiro, Cursor, VS Code, Claude Desktop).

If you prefer to install from source:

git clone https://github.com/kof70/coolify-mcp-server.git
cd coolify-mcp-server
npm install
npm run build

Then run the server (example with built index):

node build/index.js

You can also run with explicit setup flags, for example:

npx coolify-mcp-server-kof70 --setup --url https://coolify.example.com --token your-token --ide kiro

Environment variables are required for the MCP server to connect to Coolify. At minimum, set COOLIFY_BASE_URL and COOLIFY_TOKEN. Optional flags include COOLIFY_TEAM_ID for multi-team setups, COOLIFY_READONLY to enable safe read-only monitoring, and COOLIFY_REQUIRE_CONFIRM to require explicit confirmation for dangerous operations. In read-only mode, only read/list/health operations are available. If you enable confirmation, certain destructive actions (stop/restart/deploy/execute) will require a second call with confirm: true. When integrating with Claude Desktop or Kiro, you can point your MCP client at the server using the provided examples, and you can use the built-in tools like get_version, health_check, list_servers, deploy_application, execute_command, and many others listed in the README. If you encounter connection issues, verify that COOLIFY_BASE_URL is reachable and that the token has the required permissions (read/write/deploy).