# coolify

This MCP server lets Claude Code and other clients deploy, inspect, and operate Coolify infrastructure through 46 tools.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 615
- Author: StuMason
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/StuMason/coolify-mcp
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/coolify

## What it does

coolify connects an MCP client to Coolify for deployments, rollbacks, diagnostics, and resource management. Its tools cover applications, databases, services, projects, environments, logs, environment variables, storage, backups, tags, and Coolify documentation search.

The package includes 46 tools, three workflow slash commands, and two readable resources: `coolify://overview` and `coolify://application/{uuid}`. List calls return compact `uuid`, name, and status summaries, while `get_*` calls fetch a full resource. Secrets are masked, and destructive actions ask for confirmation when the client supports it.

You need a running Coolify v4 instance and an API token. The server supports Coolify v4.0 through v4.3 and uses `COOLIFY_BASE_URL` plus `COOLIFY_ACCESS_TOKEN` for local setup. Without an API token, it cannot access your Coolify instance.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `COOLIFY_ACCESS_TOKEN`, `COOLIFY_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env COOLIFY_ACCESS_TOKEN=<COOLIFY_ACCESS_TOKEN> --env COOLIFY_BASE_URL=<COOLIFY_BASE_URL> --transport stdio coolify -- npx -y @masonator/coolify-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add coolify --env COOLIFY_ACCESS_TOKEN=<COOLIFY_ACCESS_TOKEN> --env COOLIFY_BASE_URL=<COOLIFY_BASE_URL> -- npx -y @masonator/coolify-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "coolify": {
            "command": "npx",
            "args": [
                "-y",
                "@masonator/coolify-mcp"
            ],
            "env": {
                "COOLIFY_ACCESS_TOKEN": "<COOLIFY_ACCESS_TOKEN>",
                "COOLIFY_BASE_URL": "<COOLIFY_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "coolify": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@masonator/coolify-mcp"
            ],
            "env": {
                "COOLIFY_ACCESS_TOKEN": "<COOLIFY_ACCESS_TOKEN>",
                "COOLIFY_BASE_URL": "<COOLIFY_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e COOLIFY_ACCESS_TOKEN=<COOLIFY_ACCESS_TOKEN> -e COOLIFY_BASE_URL=<COOLIFY_BASE_URL> coolify npx -y @masonator/coolify-mcp
```
Replace <…> with your own values

## When to use it
- deploy applications through Coolify
- trace application and server failures
- inspect container logs
- update environment variables and storage
- check Coolify connection settings

## Example prompts
- Run `doctor` and check whether the Coolify connection is configured correctly.
- Find why this application failed and inspect its latest container logs.
- Deploy the project, but ask for confirmation before any destructive action.

## Similar
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/en/nevibecode/mcp/oh-my-posh-validator.md) — MCP server · ★ 23643
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17160
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12109

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md