coolify-mcp

MCP.Pizza Chef: StuMason

Coolify is software you install on your own machine to host apps and databases. This add-on hands Claude, Cursor, and similar assistants around forty tools for that setup, so you can ask for a redeploy, work out why a site is down, read a container's logs, change environment settings, or set up a nightly database backup in plain English. It needs a running Coolify version 4 instance and an access token from its settings page.

Coding

Use This MCP server To

Redeploy my website after pushing a change Find out why an app went down last night Read the logs for a container that keeps crashing Restart every app in one project at once Schedule a nightly backup for my database Update environment settings across several apps at once

README

Coolify MCP Server

npm version npm downloads CI Claude Desktop one-click install MCP Registry License: MIT

Manage Coolify from Claude, Cursor, or any MCP client: 44 consolidated tools for deploying, debugging, and operating your self-hosted PaaS in plain English.

📖 coolify-mcp.stumason.dev: what it does, how to install it, and why it is safe to point at production.

This README is the full reference: every tool, every gotcha, every parameter.

Install

You need a running Coolify v4 instance and an API token (Coolify → Settings → API).

Claude Desktop, one-click: download coolify-mcp.mcpb and drag it into Settings → Extensions. You'll be prompted for your Coolify URL and token. No Node install, no JSON editing.

Claude Code:

claude mcp add coolify \
  -e COOLIFY_BASE_URL="https://your-coolify-instance.com" \
  -e COOLIFY_ACCESS_TOKEN="your-api-token" \
  -- npx @masonator/coolify-mcp@latest

Any MCP client (JSON config):

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "@masonator/coolify-mcp"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance.com",
        "COOLIFY_ACCESS_TOKEN": "your-api-token"
      }
    }
  }
}

Behind Cloudflare Access or an auth proxy? Add --header "Key: Value" args (repeatable). The same config works in Cursor, Claude Code and any other MCP client, and can be repeated for multiple Coolify instances.

coolify-mcp FAQ

Is this still maintained?
Yes — the project had code changes in August 2026 and is actively developed.
Which apps does it work in?
Claude Desktop, Claude Code, Cursor, and any other assistant that supports MCP.
Do I need an access token?
Yes — create one in Coolify under Settings, and you also need a running Coolify version 4 instance.
How hard is setup?
Claude Desktop users drag in a one-click bundle; everyone else pastes a short config snippet.
Can I use this to restart a site that has gone down?
Yes — ask it to check the app's health and restart it for you.
Is it safe to point at my live server?
It makes real changes, including deletions, so read what it proposes before you confirm.