Skip to content
MCP server

Coolify

46 tools for deploying, diagnosing and managing a self-hosted Coolify from your AI client

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, API
Runs
Locally
Version
3.10.1
Listing updated
3 days ago

About Coolify

Coolify is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

This server turns a Coolify v4 instance into something you can operate by conversation. Each tool takes an action, and calling one with no arguments lists what it accepts. It covers applications, databases across eight engines, services, projects and environments.

Its diagnostic tools are diagnose_app and diagnose_server, which take a name, domain, IP or UUID, and find_issues, which scans the whole estate. deploy waits for a terminal status and returns the log tail on failure. Destructive operations ask a human first and secrets stay masked.

It installs as an MCPB bundle for Claude Desktop, with npx locally, or as a container inside Coolify using OAuth 2.1. An npx @masonator/coolify-mcp doctor command checks the URL, token and Cloudflare Access setup. It is MIT licensed.

Install

Run in a terminal

claude mcp add coolify --env COOLIFY_ACCESS_TOKEN='<COOLIFY_ACCESS_TOKEN>' -- npx -y @masonator/coolify-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "coolify": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@masonator/coolify-mcp"
      ],
      "env": {
        "COOLIFY_ACCESS_TOKEN": "<COOLIFY_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • COOLIFY_ACCESS_TOKENYour Coolify API access tokenRequired
  • COOLIFY_BASE_URLYour Coolify instance URL

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

diagnose_app
Diagnoses an application by name, domain, IP or UUID.
diagnose_server
Diagnoses a server by name, domain, IP or UUID.
find_issues
Scans the whole estate for problems.
logs
Reads logs of any container.
deploy
Deploys and waits for a terminal status.
control
Starts, stops or restarts resources.

What it does

Diagnostics
Diagnose an app or server, or scan the estate for issues.
Deploy and roll back
Deploys wait for a final status and return logs on failure.
Create resources
Applications, eight database engines, services and projects.
Safe by default
Destructive actions ask a human; secrets are masked.
Three install paths
Desktop bundle, local npx or remote container.
Doctor command
Checks configuration and token before use.

Good for

  • Find out why a deployment failed
  • Scan a Coolify estate for problems
  • Spin up a database for a new project
  • Restart a service from chat

Pricing

Open source

Free, MIT licence

Prices change. Check stumason.dev before you buy.

Coolify FAQ

What do I need?

A Coolify v4 instance and an API token from Keys & Tokens.

Can it run remotely?

Yes, as a container in Coolify with OAuth 2.1; the Coolify token stays server-side.

Does it work behind Cloudflare Access?

Yes, with an Access service token set in the environment.

Is Coolify free?

Yes. Coolify is open source, so you can use and self-host it for free.

How do I add Coolify to Claude Code?

Run this command in your terminal: claude mcp add coolify --env COOLIFY_ACCESS_TOKEN='<COOLIFY_ACCESS_TOKEN>' -- npx -y @masonator/coolify-mcp

What are the best alternatives to Coolify?

The closest alternatives to Coolify are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Coolify

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools