# Coolify MCP server

> Allows an AI client to deploy, diagnose, and manage applications, services, and databases on Coolify instances.

- Repository: https://github.com/clezcoding/awesome-coolify
- Page: https://hostedmcp.org/servers/clezcoding/awesome-coolify
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.1.2

## Install

### Claude Code

```sh
claude mcp add awesome-coolify -- npx -y awesome-coolify-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "awesome-coolify": {
      "command": "npx",
      "args": [
        "-y",
        "awesome-coolify-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "awesome-coolify": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "awesome-coolify-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"awesome-coolify","type":"stdio","command":"npx","args":["-y","awesome-coolify-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "awesome-coolify": {
      "command": "npx",
      "args": [
        "-y",
        "awesome-coolify-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add awesome-coolify -- npx -y awesome-coolify-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.awesome-coolify]
command = "npx"
args = ["-y", "awesome-coolify-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user awesome-coolify npx -- -y awesome-coolify-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "awesome-coolify": {
      "command": "npx",
      "args": [
        "-y",
        "awesome-coolify-mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `COOLIFY_MCP_LOG` | no | no |  |
| `COOLIFY_TOKEN` | no | no |  |
| `COOLIFY_URL` | no | no |  |
| `COOLIFY_VERIFY_SSL` | no | no |  |

## Tools (45)

- `health`
- `version`
- `verify`
- `infrastructure_overview`
- `list`
- `find`
- `app`
- `server`
- `scan`
- `logs`
- `analyze`
- `get`
- `deploy`
- `watch`
- `cancel`
- `preflight`
- `rollback`
- `service`
- `database`
- `create-git-app`
- `create-app-db`
- `create-one-click`
- `recommend`
- `application`
- `validate`
- `create`
- `search`
- `stop_all`
- `redeploy_project`
- `restart_project`
- `add`
- `update`
- `delete`
- `set-default`
- `import-env`
- `cloud-info`
- `upsert`
- `set`
- `remove`
- `clear`
- `sync`
- `diff`
- `audit`
- `wire`
- `resume`

## FAQ

### What can I do with this MCP server?

You can verify connectivity, discover infrastructure, create workloads, deploy, follow logs, diagnose incidents, and run emergency operations across Coolify instances.

### Is it safe to use with sensitive data?

Yes, the server includes default secret masking for passwords and tokens, and requires explicit confirmation for destructive emergency actions.
