coolify-mcp

MCP server for managing Coolify instances. Control applications, databases, services, servers, and more directly from Claude or any MCP-compatible client.

74 tools | 7 resources | 4 prompts

Installation

Claude Code

claude mcp add coolify \
  -e COOLIFY_API_URL=http://your-server:8000/api/v1 \
  -e COOLIFY_TOKEN=your-token \
  -- npx coolify-mcp

Codex

codex mcp add coolify \
  --env COOLIFY_API_URL=http://your-server:8000/api/v1 \
  --env COOLIFY_TOKEN=your-token \
  -- npx coolify-mcp

Other MCP clients

COOLIFY_API_URL=http://your-server:8000/api/v1 \
COOLIFY_TOKEN=your-token \
npx coolify-mcp

From source

git clone https://github.com/0xtlt/coolify-mcp
cd coolify-mcp && bun install
COOLIFY_API_URL=... COOLIFY_TOKEN=... bun run src/index.ts

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "coolify": {
      "command": "bun",
      "args": ["run", "/path/to/coolify-mcp/src/index.ts"],
      "env": {
        "COOLIFY_API_URL": "http://your-server:8000/api/v1",
        "COOLIFY_TOKEN": "your-token"
      }
    }
  }
}

Get your API token

Coolify dashboard: Keys & Tokens > API tokens

Available Tools

Applications (8)

| Tool | Description | |------|-------------| | coolify_list_applications | List all applications (summary) | | coolify_get_application | Get application details | | coolify_create_application | [WRITE] Create from public/private repo, Dockerfile, or Docker image | | coolify_update_application | [WRITE] Update application config | | coolify_start_application | [WRITE] Start a stopped application | | coolify_stop_application | [DESTRUCTIVE] Stop an application | | coolify_restart_application | [DESTRUCTIVE] Restart an application | | coolify_delete_application | [DESTRUCTIVE] Delete an application |

Databases (11)

| Tool | Description | |------|-------------| | coolify_list_databases | List all databases (summary) | | coolify_get_database | Get database details | | coolify_create_database | [WRITE] Create PostgreSQL, MySQL, MariaDB, MongoDB, Redis, etc. | | coolify_update_database | [WRITE] Update database config | | coolify_list_database_backups | List backups for a database | | coolify_create_database_backup | [WRITE] Create a database backup | | coolify_delete_database_backup | [DESTRUCTIVE] Delete a scheduled backup config | | coolify_start_database | [WRITE] Start a stopped database | | coolify_stop_database | [DESTRUCTIVE] Stop a database | | coolify_restart_database | [DESTRUCTIVE] Restart a database | | coolify_delete_database | [DESTRUCTIVE] Delete a database |

Services (8)

| Tool | Description | |------|-------------| | coolify_list_services | List all services (summary) | | coolify_get_service | Get service details | | coolify_create_service | [WRITE] Create a one-click Docker Compose service | | coolify_update_service | [WRITE] Update service config | | coolify_start_service | [WRITE] Start a stopped service | | coolify_stop_service | [DESTRUCTIVE] Stop a service | | coolify_restart_service | [DESTRUCTIVE] Restart a service | | coolify_delete_service | [DESTRUCTIVE] Delete a service |

Servers (8)

| Tool | Description | |------|-------------| | coolify_list_servers | List all servers (summary) | | coolify_get_server | Get server details | | coolify_create_server | [WRITE] Add a new server (requires SSH key) | | coolify_update_server | [WRITE] Update server config | | coolify_validate_server | Check SSH connectivity and Docker | | coolify_get_server_resources | List all resources on a server | | coolify_get_server_domains | List all domains on a server | | coolify_delete_server | [DESTRUCTIVE] Delete a server |

Private Keys (5)

| Tool | Description | |------|-------------| | coolify_list_private_keys | List all SSH private keys (summary) | | coolify_get_private_key | Get private key details | | coolify_create_private_key | [WRITE] Create a new SSH key | | coolify_update_private_key | [WRITE] Update an SSH key | | coolify_delete_private_key | [DESTRUCTIVE] Delete an SSH key |

Projects & Environments (9)

| Tool | Description | |------|-------------| | coolify_list_projects | List all projects (summary) | | coolify_get_project | Get project details | | coolify_create_project | [WRITE] Create a new project | | coolify_update_project | [WRITE] Update a project | | coolify_delete_project | [DESTRUCTIVE] Delete a project | | coolify_list_environments | List environments in a project | | coolify_get_environment | Get environment details | | coolify_create_environment | [WRITE] Create an environment | | coolify_delete_environment | [DESTRUCTIVE] Delete an environment |

Deployments (5)

| Tool | Description | |------|-------------| | coolify_list_deployments | List currently running/queued deployments | | coolify_list_application_deployments | List deployment history for an application (with pagination) | | coolify_get_deployment | Get deployment details | | coolify_trigger_deploy | [WRITE] Trigger a deployment | | coolify_cancel_deployment | [WRITE] Cancel a running deployment |

Application Env Vars (4)

| Tool | Description | |------|-------------| | coolify_list_envs | List env vars for an application | | coolify_create_env | [WRITE] Create an env var | | coolify_update_envs_bulk | [WRITE] Bulk update env vars | | coolify_delete_env | [DESTRUCTIVE] Delete an env var |

Service Env Vars (4)

| Tool | Description | |------|-------------| | coolify_list_service_envs | List env vars for a service | | coolify_create_service_env | [WRITE] Create a service env var | | coolify_update_service_envs_bulk | [WRITE] Bulk update service env vars | | coolify_delete_service_env | [DESTRUCTIVE] Delete a service env var |

Database Env Vars (4)

| Tool | Description | |------|-------------| | coolify_list_database_envs | List env vars for a database | | coolify_create_database_env | [WRITE] Create a database env var | | coolify_update_database_envs_bulk | [WRITE] Bulk update database env vars | | coolify_delete_database_env | [DESTRUCTIVE] Delete a database env var |

Logs (3)

| Tool | Description | |------|-------------| | coolify_get_logs | Get application logs with filtering | | coolify_get_database_logs | Get database logs with filtering | | coolify_get_service_logs | Get service logs with filtering |

System (2)

| Tool | Description | |------|-------------| | coolify_get_version | Get Coolify instance version | | coolify_healthcheck | Check if Coolify is healthy |

Teams (3)

| Tool | Description | |------|-------------| | coolify_list_teams | List all teams | | coolify_get_current_team | Get current authenticated team | | coolify_get_team_members | List members of a team |

Available Resources

| URI | Description | |-----|-------------| | coolify://applications | List of all applications | | coolify://databases | List of all databases | | coolify://services | List of all services | | coolify://servers | List of all servers | | coolify://deployments | List of all deployments | | coolify://projects | List of all projects | | coolify://private-keys | List of all SSH private keys |

Available Prompts

| Prompt | Description | |--------|-------------| | troubleshoot_deployment | Step-by-step guide to debug a failed deployment | | infrastructure_overview | Get a complete overview of all infrastructure | | deploy_application | Guided workflow to deploy an application | | setup_new_application | Guided workflow to create and configure a new app |

Safety Modes

| Variable | Description | |----------|-------------| | COOLIFY_READONLY=true | Only read operations available (list, get, logs) | | COOLIFY_REQUIRE_CONFIRM=true | Destructive operations require confirm: true |

Log Filtering

The coolify_get_logs, coolify_get_database_logs, and coolify_get_service_logs tools support:

• level: Minimum log level (debug, info, warn, error, fatal)
• since/until: ISO 8601 timestamps for time range
• search: Case-insensitive text search
• limit: Max entries (default 100)
• tail: Get most recent logs

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | COOLIFY_API_URL | Yes | Coolify API URL (e.g. http://your-server:8000/api/v1) | | COOLIFY_TOKEN | Yes | Bearer token from Coolify dashboard | | COOLIFY_TIMEOUT | No | Request timeout in ms (default: 30000) | | COOLIFY_READONLY | No | Read-only mode (default: false) | | COOLIFY_REQUIRE_CONFIRM | No | Require confirmation for destructive ops (default: false) | | DEBUG | No | Enable debug logging (default: false) |

Development

bun install              # Install dependencies
bun run dev              # Watch mode
bun run inspect          # MCP Inspector
bun run check            # Lint + typecheck + test
bun test                 # Run tests only

License

MIT