Coolify MCP Server

Manage Coolify from Claude, Cursor, or any MCP client: 45 tools for deploying, debugging, and operating your self-hosted PaaS in plain English. Destructive operations ask a human first; secrets stay masked. It runs locally over stdio via the published package.

People who work with coolify, devops and self hosted and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-17 · ★ 595 · #4 OF 153 MAINTAINED CLOUD INFRASTRUCTURE · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Coolify

before you install - you'll need

Set COOLIFY_BASE_URL, COOLIFY_ACCESS_TOKEN before connecting.

Claude Code

claude mcp add stumason-coolify-mcp -- npx -y @masonator/coolify-mcp

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @masonator/coolify-mcp - the @masonator scope differs from the repo owner (stumason); confirm it's the project's official package

registry namespace io.github.StuMason is GitHub-verified and matches the repo owner

03 · What Coolify can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v3.5.1 · 2026-09-16

Added · Outcome-scored task evals (evals/src/tasks, npm run evals:tasks). The tool-selection score counts a hit when an expected tool name appears anywhere in the transcript, so a model that calls many tools scores…

v3.5.0 · 2026-09-14

Added · MCP_HOST sets the HTTP listen address (#418, @artgas1). HTTP mode has always listened on every interface. That is right in a container and wrong on a workstation, where the server answered on whatever network…

v3.4.0 · 2026-09-11

Added · Destructive confirmation works on protocol revision 2026-07-28 (#341). That revision removed server-initiated requests mid-call, so the elicitation prompt this server has always used simply stopped working…

04 · Who maintains Coolify

coolify is maintained by stumason. We track 2 MCP servers from stumason - 2 actively maintained, 617 combined GitHub stars, oldest repo from Mar 2025. Full record: all servers from stumason.

Polar Health Data (self-hosted) Self-hosted Polar health analytics with a built-in MCP server: sleep, HRV, workouts, baselines. ★ 22

05 · Facts

repository: github.com/stumason/coolify-mcp
website: https://stumason.dev/
category: cloud infrastructure - ranked #4 of 153 actively-maintained cloud infrastructure servers as of 2026-09-18.
release cadence: 10+ releases in the last 90 days (latest 2026-09-16)
registry: io.github.StuMason/coolify (active, first published 2026-02-25 · 22 versions)
packages: npm:@masonator/coolify-mcp

06 · Coolify FAQ

What is Coolify?

Is Coolify still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-17 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

How do I install Coolify?

Run `npx -y @masonator/coolify-mcp`. The README documents 2 environment variables (COOLIFY_BASE_URL, COOLIFY_ACCESS_TOKEN) to set first. Set COOLIFY_BASE_URL, COOLIFY_ACCESS_TOKEN before connecting. You can also paste the ready-made client config above.

Does Coolify run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Coolify

Alternatives to Coolify

Maintained cloud infrastructure servers if Coolify isn't the fit.

Pairs well with

Servers that cover what Coolify doesn't - only shown when the pairing reason fits the companion.

head to head · Azure MCP Server vs Coolify · Kubernetes MCP Server vs Coolify · Ts Core vs Coolify

More cloud infrastructure MCP servers · Search Console MCP · Killbottleneck · Emfirge · Costco · Flowbite MCP

More TypeScript MCP servers · AI AppSec · Tenant Isolation · Sudzikcoin MCP Server · SumUp MCP Server · see all