Coolify

Delivers programmatic MCP tools and CLI commands to manage Coolify deployments and related resources.

javascript

6

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "felixallistar-coolify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@felixallistar/coolify-mcp",
        "--server"
      ],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      }
    }
  }
}

This MCP server lets you manage Coolify deployments from your editor or terminal, exposing a programmable control surface you can invoke from AI assistants or scripts. It provides both MCP-based tooling for AI-integrated workflows and a CLI for direct usage, enabling you to list, create, deploy, and monitor Coolify resources with consistent commands.

How to use

You connect an MCP client to a running Coolify MCP server and then issue high-level commands that map to Coolify operations. The MCP integration is designed for AI editors and cursors, while the CLI offers direct terminal access. Use either approach to perform actions like listing applications, creating services, deploying apps, and querying database types. Both interfaces expose the same capabilities, so choose the one that fits your workflow.

How to install

Prerequisites you need before starting: a working Node.js runtime and npm or npx. Ensure you have network access to your Coolify instance if you are using remote API calls.

# Install the MCP tool globally for CLI usage
npm install -g @felixallistar/coolify-mcp

# Test the installation
coolify-mcp --help

Configuration and quick start examples

Option 1: MCP Integration (Recommended) demonstrates adding a server to your MCP configuration.

{
  "mcpServers": {
    "coolify-mcp": {
      "command": "npx",
      "args": ["-y", "@felixallistar/coolify-mcp", "--server"],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      }
    }
  }
}

Configuration and quick start examples

Option 2: Global installation (CLI) shows an alternative way to run the MCP server.

{
  "mcpServers": {
    "coolify-mcp": {
      "command": "coolify-mcp",
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      }
    }
  }
}

Enablement in clients and usage notes

If you are using Cursor for MCP integration, enable the Coolify MCP in Cursor Settings under the MCP tab and toggle on coolify-mcp. This connects your cursor-based editor directly to your Coolify deployment space.

Examples of common actions

In your AI chat or command interface, you can request actions like listing applications, creating services, deploying apps, or showing available database types. The MCP surface translates these requests into the corresponding Coolify operations.