Skip to main content
plugin CX Codex

Coolify — Claude Code plugin: deployment and app control

This plugin connects Claude Code to Coolify Cloud or a self-hosted Coolify instance, letting the agent manage applications, view deployment history, check logs, and control environment variables through the Coolify API.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install coolify@awesome-codex-plugins
Open on GitHub

What coolify does

Coolify is a deployment platform that runs applications, databases, and services. The plugin exposes core operations: list applications, databases, projects, servers, and resources; start, stop, or restart services; read deployment history and recent logs; manage environment variables across apps. It includes purpose-built tools for common workflows, a generic coolify_request tool for any /api/v1 endpoint, and coolify_openapi_search to find endpoints in the bundled OpenAPI schema.

Requires Node.js 20 or later. Create an API token in Coolify's /security/api-tokens page; use the least-privileged token your workflow needs. For self-hosted instances, ensure API access is enabled and provide the instance URL. The token is stored in the system credential store (macOS Keychain, Windows Credential Manager, Linux Secret Service via secret-tool), or locally under CODEX_HOME with owner-only permissions if no native store is available.

After installation, start a new Claude Code thread and type "Connect Coolify." The plugin opens a local setup page where you choose Coolify Cloud or self-hosted, then enter the token. For local development, use npm run setup commands.

What it helps with

  • Check Coolify instance health and version without leaving the editor
  • Start, stop, or restart applications and services on demand
  • Review deployment history and recent logs for troubleshooting
  • Update environment variables across multiple applications at once
  • Trigger a deployment manually by UUID or tag

Example prompts for the agent

  • "Check Coolify health and show the version."
  • "List all applications in the project, then restart the backend app."
  • "Fetch the last 50 logs from the database service and look for errors."

How to install coolify

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install coolify@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about coolify

How do I install the Coolify plugin for Claude Code?

Run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install coolify@awesome-codex-plugins. In a new thread, type "Connect Coolify," and the plugin will open a local setup page to enter your API token.

What does the Coolify plugin do?

It exposes Coolify's API to Claude Code agents: health checks, resource listings, lifecycle control for apps and services, deployment history, logs, and environment variable management. It also includes a generic tool to call any Coolify API endpoint and search the OpenAPI schema.

Do I need Coolify Cloud or can I use a self-hosted instance?

Both work. For Coolify Cloud, create a token at /security/api-tokens on https://app.coolify.io. For self-hosted, confirm API access is enabled, then provide the instance URL and a token to the plugin during setup.

Source text

coolify-codex-plugin · MIT
# Coolify Codex Plugin

Control Coolify Cloud or a self-hosted Coolify instance from Codex through a local MCP server and a Coolify-aware workflow skill.

The plugin is built around a sanitized endpoint index generated from Coolify's official OpenAPI spec for the `v4.x` branch. It includes named tools for the workflows agents use most often, plus a generic API request tool and OpenAPI search for complete endpoint coverage as Coolify evolves.

## Capabilities

- Check Coolify health and version.
- List and inspect applications, databases, deployments, projects, resources, servers, services, and teams.
- Start, stop, and restart applications, databases, and services.
- Trigger deployments by UUID or tag.
- Read deployment history across applications without mistaking the running-deployments endpoint for full history.
- Read recent application logs.
- List, create, update, bulk update, and delete environment variables.
- Call any Coolify `/api/v1` endpoint with `coolify_request`.
- Search the bundled OpenAPI file with `coolify_openapi_search`.

## Requirements

- Node.js 20 or newer.
- Coolify Cloud, or a self-hosted Coolify instance with API access enabled.
- A Coolify API token.

## Install from GitHub

Add the Awesome Codex Plugins marketplace and install Coolify:

```bash
codex plugin marketplace add hashgraph-online/awesome-codex-plugins --ref main
codex plugin add coolify@awesome-codex-plugins
```

The plugin is also listed in the [Awesome Codex Plugins registry](https://github.com/hashgraph-online/awesome-codex-plugins#tools--integrations).

Create an API token in Coolify at `/security/api-tokens`. Use the least-privileged token that can perform the work you want Codex to do.

After installing from the Codex plugin marketplace, start a new Codex thread and ask:

```text
Connect Coolify
```

Codex will open a short-lived local setup page. Choose Coolify Cloud or self-hosted first; for self-hosted instances, enter the instance URL so the matching token page is shown. The token is saved locally and is not returned to the chat.

For local development, you can also run:

```bash
npm run setup
npm run setup -- --save
```

For local development without a URL argument, the terminal helper targets Coolify Cloud at `https://app.coolify.io`. Pass a URL when you want to use a self-hosted instance.

## Configuration

Marketplace users should use the browser setup opened by `coolify_configure`; it asks whether the instance is Coolify Cloud or self-hosted before showing a token link. For local development, run:

```bash
npm run setup -- --save
```

For self-hosted instances, pass either the instance root or the API root:

```bash
npm run setup -- --save https://coolify.example.com
npm run setup -- --save https://coolify.example.com/api/v1
```

The token is stored in the operating system credential store when available: macOS Keychain, Windows Credential Manager, or Linux Secret Service via `secret-tool`. If no native credential store is available, the plugin stores it in a local config file under `CODEX_HOME` or `~/.codex` with owner-only permissions. `COOLIFY_BASE_URL` and `COOLIFY_API_TOKEN` are still supported as fallbacks for automation.

## MCP Tools

| Tool | Purpose |
| --- | --- |
| `coolify_setup` | Generate setup URLs and token guidance. |
| `coolify_configure` | Open a local browser setup page or save a Coolify URL and API token locally. |
| `coolify_config_status` | Check whether a connection is configured without revealing the token. |
| `coolify_logout` | Remove the saved local connection. |
| `coolify_health` | Check instance health and version. |
| `coolify_openapi_search` | Find official endpoints, schemas, and request shapes. |
| `coolify_request` | Call any relative Coolify API path. |
| `coolify_list` | List common resource kinds. |
| `coolify_get` | Fetch one common resource. |
| `coolify_lifecycle` | Start, stop, or restart a resource. |
| `coolify_deploy` | Trigger a deployment. |
| `coolify_deployment_history` | List deployment history for one application or all applications. |
| `coolify_application_logs` | Fetch application logs. |
| `coolify_envs` | Manage environment variables. |

Sensitive-looking fields are redacted by default. Some tools accept `revealSensitive: true` for cases where the raw API response is explicitly needed.

`coolify_list` with `kind: "deployment"` mirrors Coolify's `GET /deployments` endpoint, which lists currently running deployments. Use `coolify_deployment_history` when you need historical deployments.

## Development

```bash
npm run setup -- --no-open
npm run setup -- --no-open https://coolify.example.com
npm run setup -- --save https://coolify.example.com
npm run check
npm run inspect:openapi
```

The MCP server and setup helper are dependency-free and use only Node.js built-ins. The server is written in plain JavaScript so the plugin can run directly without a TypeScript build step.

## Sources

- Coolify authorization docs: <https://coolify.io/docs/api-reference/authorization>
- Coolify OpenAPI source: <https://github.com/coollabsio/coolify/blob/v4.x/openapi.json>
- Coolify CLI automation reference: <https://github.com/coollabsio/coolify-cli>

## License

MIT

© Severin Hilbert · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for DevOps and infrastructure →

From the same set391

The whole set →
dataproduct-builder-dbt dataproduct-builder-dbt — a plugin for Claude Code and Codex that covers the full dbt data-product lifecycle: scaffold, implement models from a data contract, audit live data, and sync metadata to Entropy Data. CX Codex ★ 1,596repo stars darkmoon An MCP server for your own Darkmoon Pro instance: launch an authorized pentest run, then check its status, campaigns and findings from the agent. CX Codex ★ 1,596repo stars damnpdfs Connects 71 tools for PDFs, Office documents and images through a paired DamnPDFs browser tab. CX Codex ★ 1,596repo stars court-rules court-rules is a Claude Code and Codex plugin that searches US federal and state filing rules, judges’ standing orders, and court holidays. Results cite the court’s own documents. CX Codex ★ 1,596repo stars context-pack context-pack generates a compact first-pass repository briefing for coding agents. It saves initial tool calls when exploring unfamiliar codebases. CX Codex ★ 1,596repo stars contam-tools The contam-tools plugin connects an agent to a local CONTAM MCP server to inspect project files, run simulations, and review outputs. It fits workflows built around .prj models and ContamW. CX Codex ★ 1,596repo stars computer-usage-summary-skill computer-usage-summary-skill turns local ActivityWatch data into a daily report of app time, AFK, a timeline and foreground browser pages. Nothing leaves the machine. CX Codex ★ 1,596repo stars cometchat-skills Adds CometChat text chat, voice, and video calling skills to React, Angular, React Native, iOS, Android, and Flutter projects using the live Docs MCP. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open