Coolify MCP Server

by frndchagasio.github.frndchagas/coolify-mcpv2.3.1

Manage self-hosted Coolify PaaS: deployments with verified builds, app diagnostics, database backups, offline docs search and confirmed destructive actions.

3Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained32d ago

Install Coolify MCP server

claude mcp add coolify -e COOLIFY_BASE_URL='<coolify-base-url>' -e COOLIFY_TOKEN='<coolify-token>' -- npx -y @fndchagas/coolify-mcp

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": [
        "-y",
        "@fndchagas/coolify-mcp"
      ],
      "env": {
        "COOLIFY_BASE_URL": "<coolify-base-url>",
        "COOLIFY_TOKEN": "<coolify-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": [
        "-y",
        "@fndchagas/coolify-mcp"
      ],
      "env": {
        "COOLIFY_BASE_URL": "<coolify-base-url>",
        "COOLIFY_TOKEN": "<coolify-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "coolify": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@fndchagas/coolify-mcp"
      ],
      "env": {
        "COOLIFY_BASE_URL": "<coolify-base-url>",
        "COOLIFY_TOKEN": "<coolify-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": [
        "-y",
        "@fndchagas/coolify-mcp"
      ],
      "env": {
        "COOLIFY_BASE_URL": "<coolify-base-url>",
        "COOLIFY_TOKEN": "<coolify-token>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
COOLIFY_BASE_URL	yes	—	Coolify API base URL.
COOLIFY_TOKEN	yes	yes	Coolify API token.
COOLIFY_STRICT_VERSION	—	—	Fail on version mismatch.
COOLIFY_ALLOW_WRITE	—	—	Enable write operations.
COOLIFY_ALLOW_UNSAFE_LOGS	—	—	Allow raw logs without redaction (unsafe).
COOLIFY_OPENAPI_REF	—	—	Override OpenAPI version ref (optional).

Freshness

Maintained — last maintenance signal 32d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-08 · 32d ago · GitHub
Latest release
2026-08-24 · 47d ago · GitHub · coolify-mcp-v2.3.1
Package published
no data · npm/PyPI
Registry entry updated
2026-08-24 · 47d ago · official registry · v2.3.1

FAQ

›How do I install the Coolify MCP server in Claude Code?

Run: claude mcp add coolify -e COOLIFY_BASE_URL='<coolify-base-url>' -e COOLIFY_TOKEN='<coolify-token>' -- npx -y @fndchagas/coolify-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Coolify require an API key?

Yes. It expects COOLIFY_BASE_URL, COOLIFY_TOKEN, of which 1 is a secret.

›Can I use Coolify as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Coolify in the official MCP registry?

Yes, as io.github.frndchagas/coolify-mcp.