Manage 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.
How to install coolify-mcp?
stumason/coolify-mcp
$git clone https://github.com/stumason/coolify-mcpInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install coolify-mcp by running `git clone https://github.com/stumason/coolify-mcp`, then use it for the current task and follow its documentation at https://github.com/stumason/coolify-mcp.
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 |
Related
6 picksType
- mcp-server-circleciA Model Context Protocol (MCP) server implementation for CircleCI, enabling natural language interactions with CircleCI functionality through MCP-enabled clientsJul 2026
- mcp-for-argocdArgo CD MCP ServerJul 2026
- mcp-server-kubernetesMCP server for interacting with Kubernetes clusters via kubectlJul 2026
- hookdeck-cliCLI for Hookdeck: forward webhooks to localhost (ngrok alternative), manage and query Event Gateway resources (sources, connections, destinations, events), run the MCP server for AI agents. Free for dev.Jul 2026
- heroku-mcp-serverHeroku Platform MCP ServerJul 2026
- mcp-server-azure-devopsAzure DevOps reference server for the Model Context Protocol (MCP)Jul 2026
