npm package: @iflow-mcp/coolify-mcp-server
Description: MCP server for Coolify API integration
Author: Will Reeves
Latest version: 0.1.13

# Coolify MCP Server

<img src="graphics/CoolifyMCP.png" width="256" alt="Coolify MCP Logo" />

A Model Context Protocol server that provides integration with the Coolify API. This server enables interaction with Coolify instances through MCP tools.

> **Compatibility:** Supports Coolify version 4.0.0-beta.380+ with automatic version detection and feature compatibility. Tested with versions up to 4.0.0-beta.420.1. API endpoints updated to match official Coolify documentation.

## Prerequisites

- Node.js 18 or higher
- Coolify Base URL
- Coolify API token

## Features

- Teams management (list, get details, members)
- **Project management (list, get, create)** ✨ **NEW**
- **Environment management (list, create within projects)** ✨ **NEW**
- Server management (create, validate, resources, domains)
- Service lifecycle management (create, start, stop, restart)
- Application lifecycle management (create, start, stop, restart, execute commands)
- Deployment tracking
- Private key management
- Version and health checks
- **Enhanced error reporting with detailed validation messages** ✨ **IMPROVED**
- **Coolify UUID format compatibility** ✨ **FIXED**

## Installation

```bash
# Install globally
npm install -g coolify-mcp-server

# Or use with npx
npx coolify-mcp-server
```

## Configuration

The server requires two environment variables:

- `COOLIFY_BASE_URL`: The base URL of your Coolify instance
- `COOLIFY_TOKEN`: Your Coolify API token

### Getting an API Token

1. Go to your Coolify instance
2. Navigate to `Keys & Tokens` / `API tokens`
3. Create a new token with the following required permissions:
   - read (for fetching information)
   - write (for managing resources)
   - deploy (for deployment operations)

## Usage

### In MCP Settings

Add the following to your MCP settings configuration:

```json
{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "your-coolify-url",
        "COOLIFY_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

Windows Cline users may need the following:

```json
{
  "mcpServers": {
    "coolify": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "coolify-mcp-server"
      ],
      "env": {
        "COOLIFY_BASE_URL": "your-coolify-url",
        "COOLIFY_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

### Available Tools

#### Version & Health
- `get_version`: Get Coolify version information
- `health_check`: Check Coolify API health status

#### Teams
- `list_teams`: List all teams
- `get_team`: Get details of a specific team
- `get_current_team`: Get current team details
- `get_current_team_members`: Get current team members

#### Servers
- `list_servers`: List all servers
- `create_server`: Create a new server
- `validate_server`: Validate server configuration
- `get_server_resources`: Get server resource usage
- `get_server_domains`: Get server domains

#### Projects ✨ **NEW**
- `list_projects`: List all projects
- `get_project`: Get details of a specific project
- `create_project`: Create a new project

#### Environments ✨ **NEW**  
- `list_environments`: List environments in a project
- `create_environment`: Create a new environment within a project

#### Services
- `list_services`: List all services
- `create_service`: Create a new service
- `start_service`: Start a service
- `stop_service`: Stop a service
- `restart_service`: Restart a service

#### Applications
- `list_applications`: List all applications
- `create_application`: Create a new application
- `start_application`: Start an application
- `stop_application`: Stop an application
- `restart_application`: Restart an application
- `execute_command_application`: Execute command in application container
- `get_application_logs`: Get application logs for debugging

#### Deployments
- `list_deployments`: List all deployments
- `get_deployment`: Get deployment details

#### Private Keys
- `list_private_keys`: List all private keys
- `create_private_key`: Create a new private key

## License

MIT