What is Coolify Mcp

coolify-mcp is a Model Context Protocol (MCP) server designed for managing Coolify deployments, offering both programmatic MCP tools and a comprehensive CLI for user interaction.

Use cases

Use cases for coolify-mcp include listing Coolify applications, creating new services like WordPress, deploying applications, and querying available database types.

How to use

To use coolify-mcp, integrate it into your MCP configuration for either Cursor or VS Code. You can also install it globally for CLI usage. After configuration, you can manage your Coolify applications through commands in your AI chat or via the command line.

Key features

Key features of coolify-mcp include 100% API coverage, easy integration with AI editors, comprehensive CLI commands, and the ability to manage Coolify applications seamlessly.

Where to use

coolify-mcp can be used in software development environments, particularly where Coolify is utilized for application deployment and management, enhancing developer productivity.

Coolify MCP Server

A Model Context Protocol (MCP) server for managing Coolify deployments, providing both programmatic MCP tools and comprehensive CLI commands.

Quick Start

Option 1: MCP Integration (Recommended)

MCP (Model Control Protocol) lets you manage Coolify directly from your AI editor.

1. Add to your MCP configuration

For Cursor:
Add to ~/.cursor/mcp.json or <project_folder>/.cursor/mcp.json:

{
  "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"
      }
    }
  }
}

For VS Code:
Add to <project_folder>/.vscode/mcp.json:

{
  "servers": {
    "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"
      },
      "type": "stdio"
    }
  }
}

🔑 Replace your-coolify-instance.com with your actual Coolify URL and your-coolify-api-token with your API token from Coolify Settings > API.

2. (Cursor only) Enable Coolify MCP

Open Cursor Settings (Ctrl+Shift+J) ➡ Click on MCP tab ➡ Enable coolify-mcp with the toggle

3. Start managing Coolify

In your AI chat, try commands like:

List my Coolify applications
Create a new WordPress service called "my-blog" 
Deploy my app with ID "app-123"
Show me all available database types

Option 2: CLI Usage

Installation

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

# Test the installation
coolify-mcp --help

Configuration

Create a .env file in your project directory:

# Required: Your Coolify instance URL (include port if needed)
COOLIFY_API_URL=https://your-coolify-instance.com

# Required: Your Coolify API token (generate in Coolify Settings > API)
COOLIFY_API_TOKEN=your-coolify-api-token

Common Commands

# Application management
coolify-mcp apps list
coolify-mcp apps create-public --name "my-app" --repository "https://github.com/user/repo" --project "project-id"
coolify-mcp apps start app-id

# Service management (70+ one-click services)
coolify-mcp services types
coolify-mcp services create --name "my-blog" --type "wordpress-with-mysql" --project "project-id"

# Database management (8 database types)
coolify-mcp databases create-postgresql --name "main-db" --project "project-id"
coolify-mcp databases create-redis --name "cache" --project "project-id"

# Project management
coolify-mcp projects list
coolify-mcp projects create --name "My Project"

# Test connectivity
coolify-mcp system health

Features

🔄 Applications (21 Operations)

Complete application lifecycle management with 6 deployment types, environment variables, logs, and control operations.

🔧 Services (14 Operations)

70+ one-click services including WordPress, Ghost, MinIO, and more with full environment management.

🗄️ Databases (13 Operations)

8 database types: PostgreSQL, MySQL, MariaDB, MongoDB, Redis, KeyDB, ClickHouse, Dragonfly.

📂 Projects, Servers, Deployments

Complete infrastructure management including private keys, system administration, and deployment monitoring.

MCP Tools vs CLI Commands

This package provides two interaction methods with complete feature parity:

• 🤖 MCP Tools: For AI agents and Cursor integration (recommended)
• 💻 CLI Commands: For direct terminal usage

Both interfaces provide identical functionality - choose based on your workflow.

Development

Automated API Updates

Stay in sync with Coolify’s latest API:

npm run refresh           # Download latest API spec and rebuild
npm run check-updates     # Check for API changes

Manual Development

git clone https://github.com/FelixAllistar/coolify-mcp.git
cd coolify-mcp
npm install
npm run refresh
npm run dev

API Coverage

✅ 100% Coolify API Coverage - Applications, Services, Databases, Projects, Servers, Deployments, Private Keys, System Administration

License

GLWTPL (Good Luck With That Public License) - see LICENSE file for details.

This software might just work or not, there is no third option. Good luck and Godspeed.

MCP Configuration

Option 1: Using npx (Recommended - Simple!)

{
  "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"
      }
    }
  }
}

Option 2: Direct node execution

{
  "mcpServers": {
    "coolify-mcp": {
      "command": "node",
      "args": [
        "node_modules/@felixallistar/coolify-mcp/dist/index.js",
        "--server"
      ],
      "env": {
        "COOLIFY_API_URL": "https://your-coolify-instance.com",
        "COOLIFY_API_TOKEN": "your-coolify-api-token"
      }
    }
  }
}

Option 3: Global installation

npm install -g @felixallistar/coolify-mcp

Then use the MCP server binary:

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

CLI Usage

For CLI commands, simply add arguments to the coolify-mcp command:

# Using npx (no installation needed)
npx @felixallistar/coolify-mcp --help
npx @felixallistar/coolify-mcp apps list

# Or install globally for easier CLI usage
npm install -g @felixallistar/coolify-mcp
coolify-mcp --help
coolify-mcp apps list