coolify-mcp
installs/mo · npmstarsforks
How to install coolify-mcp?
stumason/coolify-mcp
$git clone https://github.com/StuMason/coolify-mcpManage Coolify through natural language — 42 token-optimized MCP tools for deploying, debugging, and operating your self-hosted PaaS from Claude, Cursor, or any MCP client.
README.md
| 1 | # Coolify MCP Server |
| 2 | |
| 3 | [](https://www.npmjs.com/package/@masonator/coolify-mcp) |
| 4 | [](https://www.npmjs.com/package/@masonator/coolify-mcp) |
| 5 | [](https://github.com/StuMason/coolify-mcp/actions/workflows/ci.yml) |
| 6 | [](https://github.com/StuMason/coolify-mcp/releases/latest/download/coolify-mcp.mcpb) |
| 7 | [](https://registry.modelcontextprotocol.io) |
| 8 | [](https://opensource.org/licenses/MIT) |
| 9 | |
| 10 | Manage [Coolify](https://coolify.io/) through natural language — 42 token-optimized MCP tools for deploying, debugging, and operating your self-hosted PaaS from Claude, Cursor, or any MCP client. |
| 11 | |
| 12 | 📖 **Full docs: [coolify-mcp.stumason.dev](https://coolify-mcp.stumason.dev)** — install guide, tools reference, architecture, security model, v3 roadmap. |
| 13 | |
| 14 | ## Install |
| 15 | |
| 16 | You need a running Coolify v4 instance and an API token (Coolify → Settings → API). |
| 17 | |
| 18 | **Claude Desktop — one-click:** download [`coolify-mcp.mcpb`](https://github.com/StuMason/coolify-mcp/releases/latest/download/coolify-mcp.mcpb) and drag it into **Settings → Extensions**. You'll be prompted for your Coolify URL and token — no Node install, no JSON editing. |
| 19 | |
| 20 | **Claude Code:** |
| 21 | |
| 22 | ```bash |
| 23 | claude mcp add coolify \ |
| 24 | -e COOLIFY_BASE_URL="https://your-coolify-instance.com" \ |
| 25 | -e COOLIFY_ACCESS_TOKEN="your-api-token" \ |
| 26 | -- npx @masonator/coolify-mcp@latest |
| 27 | ``` |
| 28 | |
| 29 | **Any MCP client (JSON config):** |
| 30 | |
| 31 | ```json |
| 32 | { |
| 33 | "mcpServers": { |
| 34 | "coolify": { |
| 35 | "command": "npx", |
| 36 | "args": ["-y", "@masonator/coolify-mcp"], |
| 37 | "env": { |
| 38 | "COOLIFY_BASE_URL": "https://your-coolify-instance.com", |
| 39 | "COOLIFY_ACCESS_TOKEN": "your-api-token" |
| 40 | } |
| 41 | } |
| 42 | } |
| 43 | } |
| 44 | ``` |
| 45 | |
| 46 | Behind Cloudflare Access or an auth proxy? Add `--header "Key: Value"` args (repeatable). Cursor, multiple Coolify instances, and proxy setups are covered in the [install guide](https://coolify-mcp.stumason.dev/guide/installation). |
| 47 | |
| 48 | ## Tools |
| 49 | |
| 50 | | Category | Tools | |
| 51 | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | |
| 52 | | **Infrastructure** | `get_infrastructure_overview`, `get_mcp_version`, `get_version`, `system` (health, list_resources, enable/disable API) | |
| 53 | | **Diagnostics** | `diagnose_app`, `diagnose_server`, `find_issues` | |
| 54 | | **Batch Operations** | `restart_project_apps`, `bulk_env_update`, `stop_all_apps`, `redeploy_project` | |
| 55 | | **Servers** | `list_servers`, `get_server`, `validate_server`, `server_resources`, `server_domains` | |
| 56 | | **Projects** | `projects` (list, get, create, update, delete via action param) | |
| 57 | | **Environments** | `environments` (list, get, create, delete via action param) | |
| 58 | | **Applications** | `list_applications`, `get_application`, `application` (CRUD + delete_preview), `application_logs` | |
| 59 | | **Databases** | `list_databases`, `get_database`, `database` (create 8 types, delete), `database_backups` (CRUD schedules, executions incl. delete) | |
| 60 | | **Services** | `list_services`, `get_service`, `se |
People who liked this also viewed
6 picksType
- mcp-proxy-for-awsAWS MCP Proxy ServerMCP ServersJul 2026
- pydantic-ai-backendFile Storage & Sandbox Backends for Pydantic AI: console tools for file operations, Docker-isolated sandboxes for safe execution, and permission system with presets for access control. Enables secure multi-user handling and testing in agents via in-memory, local, or containerized storage.MCP ServersJul 2026
- mcp-for-argocdAn implementation of Model Context Protocol (MCP) server for Argo CD.MCP ServersJul 2026
- heroku-mcp-serverHeroku Platform MCP Server using the Heroku CLIMCP ServersJul 2026
- ghost-mcpA Model Context Protocol (MCP) server for interacting with Ghost CMS through LLM interfaces like Claude. Allow you to control your Ghost blog by simply asking Claude etc.MCP ServersApr 2026
- Google DriveUpload, organize, and share files in the cloud. Manage folders, set permissions, and search across stored documents.MCP Serversrecently
