frndchagas/coolify-mcp

MCP server for Coolify API - enables full deployment workflows from zero to production.
Targets the **Coolify v4.3.10** API. Types and schemas are generated directly from Coolify's official OpenAPI spec, so tool inputs always match what the API actually accepts.
Features
- **Full Deployment Workflow**: Create projects, environments, servers, and applications from scratch
- **5 Application Types**: one createApplication tool covers public git, GitHub App, Deploy Key, Dockerfile, and Docker Image sources — plus Docker Compose deployments via createService (since Coolify v4.1, compose deployments are services)
- **Environment Management**: Full CRUD for environment variables with secret masking
- **Deployment Control**: Deploy (optionally waiting for the terminal status, with a log tail on failure), start, stop, restart applications
- **Diagnostics**: diagnoseApp finds an app by UUID, name, or domain and aggregates status, recent deployments, failure log tails, runtime logs, and suggested next actions
- **Docs Search**: searchDocs runs full-text search across the official Coolify documentation from a bundled local index — no network needed
- **Security**: Write protection, secret redaction, and MCP annotations (readOnlyHint/destructiveHint) so clients can auto-approve reads and gate destructive calls
- **Near-full API coverage**: databases (8 engines, backups, envs), services, storages, scheduled tasks, teams, previews, servers, SSH keys, and GitHub Apps
- **Token-efficient**: 65 tools whose definitions cost ~9k tokens of context, with strict runtime validation against schemas generated from Coolify's OpenAPI spec
Requirements
- Node 18+
- A Coolify API token (Settings > API in your Coolify dashboard)
Install
**Claude Desktop, one-click:** download coolify-mcp.mcpb from the latest release and drag it into **Settings → Extensions**. You'll be prompted for your Coolify URL and token — no Node install, no JSON editing.
**Via npm:**
Quick Start
Claude Code CLI
OpenAI Codex CLI
Or edit ~/.codex/config.toml:
Manual Configuration (~/.mcp.json)
Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| COOLIFY_BASE_URL | required | Coolify API URL (e.g., https://coolify.example.com/api/v1) |
| COOLIFY_TOKEN | required | API token from Coolify Settings > API |
| COOLIFY_ALLOW_WRITE | true | Enable write operations (create, update, delete, deploy) |
| COOLIFY_STRICT_VERSION | false | Fail on API version mismatch |
| COOLIFY_MCP_ELICITATION | on | Set to off to skip human confirmation on destructive deletes (escape hatch for clients that advertise elicitation but do not implement it) |
| MCP_TRANSPORT | stdio | Transport: stdio, http, both |
| PORT | 7331 | HTTP port (when using http transport) |
| MCP_HTTP_TOKEN | unset | Bearer token required on /mcp requests (HTTP transport). Setting it also switches the default bind to 0.0.0.0 |
| MCP_HTTP_HOST | 127.0.0.1 (0.0.0.0 with token) | Interface the HTTP transport binds to. Binding beyond loopback without a token logs a loud warning |
Deploy from Zero
With this MCP, you can deploy an application from scratch:
Tools Reference
Projects & Environments
| Tool | Description | Write |
|------|-------------|-------|
| listProjects | List all projects | |
| createProject | Create a new project | ✓ |
| updateProject | Update project name/description | ✓ |
| deleteProject | Delete a project and all its resources | ✓ |
| listEnvironments | List environments in a project | |
| createEnvironment | Create a new environment | ✓ |
Servers & Infrastructure
| Tool | Description | Write |
|------|-------------|-------|
| listServers | List all servers | |
| getServer | Get server details | |
| createServer | Create a new server | ✓ |