# coolify-mcp

> MCP server for Coolify — 38 optimized tools for managing self-hosted PaaS through AI assistants

- **URL**: https://www.freshcrate.ai/projects/coolify-mcp
- **Author**: StuMason
- **Category**: MCP Servers
- **Latest version**: `v2.12.0` (2026-05-30)
- **License**: MIT
- **Source**: https://github.com/StuMason/coolify-mcp
- **Homepage**: https://stumason.dev
- **Language**: TypeScript
- **GitHub**: 323 stars, 47 forks
- **Registry**: github
- **Tags**: `ai`, `claude`, `coolify`, `deployment`, `devops`, `infrastructure`, `mcp`, `model-context-protocol`, `typescript`

## Description

MCP server for Coolify — 38 optimized tools for managing self-hosted PaaS through AI assistants

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v2.12.0` | 2026-05-30 | High | ## What's Changed   ### Security  - **`list_resources` masks webhook secrets and basic-auth credentials by default** (#204) — when `system({ action: 'list_resources', include_full: true })` is called, the per-resource fields `manual_webhook_secret_github` / `manual_webhook_secret_gitlab` / `manual_webhook_secret_gitea` / `manual_webhook_secret_bitbucket` and `http_basic_auth_password` are now replaced with `'***'` so an MCP client / LLM granted "list resources" cannot silently exfiltrate webhook |
| `v2.11.0` | 2026-05-18 | High | ## What's Changed   ### Added (#172, thanks @opastorello)  Net tool count: 38 → 42 (after consolidation; original PR proposed 45 before review).  - **`storages` tool** — list/create/update/delete persistent or file storages for application/database/service. Single consolidated tool with action+resource pattern. - **`scheduled_tasks` tool** — list/create/update/delete/list_executions for application or service. Consolidated. - **`hetzner` tool** — list_locations, list_server_types, list_images, l |
| `v2.10.0` | 2026-05-14 | High | ## What's Changed   ### Added  - **Application build-config and `health_check_*` fields now wired through `create_*`** (#185 / #178, thanks @kashik0i) — eight build-config fields (`dockerfile_location`, `dockerfile_target_build`, `base_directory`, `publish_directory`, `install_command`, `build_command`, `start_command`, `watch_paths`) added to the `application` tool's zod schema; all twelve `health_check_*` fields plus the build-config fields now forwarded by `create_public`, `create_github`, `c |
| `v2.9.0` | 2026-05-11 | High | ## What's Changed   ### Security  - **`env_vars` list now masks values by default** (#159 / #182, thanks @daniel-rudaev for reporting) — `value` and `real_value` on `env_vars` list responses are now replaced with `***` so plaintext secrets are not leaked to MCP clients / LLMs. Metadata (uuid, key, `is_buildtime`, `is_runtime`, timestamps, ids) is untouched. Applied at the API boundary in `listApplicationEnvVars` and `listServiceEnvVars` so both the summary and full projections are protected. `bu |
| `v2.8.1` | 2026-04-28 | High | ## What's Changed   ### Added  - **`--header` CLI flag for custom HTTP headers** (#167, thanks @imantsk) — Inject extra headers (e.g. `--header "CF-Access-Client-Id: ..." --header "CF-Access-Client-Secret: ..."`) on every outbound request. Useful for Cloudflare Zero Trust, custom auth proxies, and other middleware sitting in front of Coolify. Multiple `--header` flags can be combined. Reserved headers (`Authorization`, `Content-Type`) are filtered with a warning to prevent silently overriding th |
| `v2.7.3` | 2026-02-25 | Low | ## Coolify MCP is now on the [official MCP Registry](https://registry.modelcontextprotocol.io) 🎉  Search for `io.github.StuMason/coolify` in any MCP-compatible client to discover and install.  ### What's in v2.7.x  **3 new tools (35 → 38):** - **`teams`** — list, get, get_members, get_current, get_current_members - **`cloud_tokens`** — Hetzner/DigitalOcean: list, get, create, update, delete, validate - **`search_docs`** — Full-text search across Coolify docs. 1,500+ chunks indexed, ~849 tokens |
| `v2.7.2` | 2026-02-25 | Low | ## What's Changed   ### Added  - **MCP Registry publishing** - Added `mcpName` field and `server.json` for publishing to the official MCP Registry as `io.github.StuMason/coolify`  ---  📦 [View on npm](https://www.npmjs.com/package/@masonator/coolify-mcp/v/2.7.2) |
| `v2.7.1` | 2026-02-25 | Low | ## What's Changed   ### Fixed  - **Documentation overhaul** - Comprehensive update to all project documentation:   - Fixed stale tool counts across README.md and CLAUDE.md (35 → 38)   - Fixed incorrect tool names in README (`get_server_resources` → `server_resources`, `get_server_domains` → `server_domains`)   - Added detailed Available Tools entries for `teams`, `cloud_tokens`, `search_docs`, `github_apps`   - Added deployment log `page` param and `logs_meta` to deployment tool docs   - Added e |
| `v2.7.0` | 2026-02-25 | Low | ## What's Changed   ### Added  - **`teams` tool** - Manage teams: list, get, get_members, get_current, get_current_members - **`cloud_tokens` tool** - Manage cloud provider tokens (Hetzner/DigitalOcean): list, get, create, update, delete, validate - **`search_docs` tool** - Search Coolify documentation using local full-text search (BM25 via MiniSearch). Fetches docs from coolify.io on first search, indexes 1500+ chunks, returns token-efficient results (~849 tokens for 5 results) - **Version cach |
| `v2.6.6` | 2026-02-25 | Low | ## What's Changed   ### Fixed  - **Deployment log truncation** - `lines` param now works correctly (#115):   - Coolify returns deployment logs as a JSON array in a single line — `truncateLogs` was splitting on newlines and finding none   - Now parses JSON array format, filters hidden entries (docker internals), formats as readable `[timestamp] output` lines   - 96KB raw JSON → 771 chars for `lines: 10` (99.2% reduction)  ### Added  - **Log pagination** - `page` param on deployment get with logs |

## Citation

- HTML: https://www.freshcrate.ai/projects/coolify-mcp
- Markdown: https://www.freshcrate.ai/projects/coolify-mcp.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/coolify-mcp/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._