Coolify Server Integration – README | MCP Marketplace

✨ From vibe coding to vibe deployment. UBOS MCP turns ideas into infra with one message.

Learn more

Coolify MCP Server

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: Tested with Coolify version 4.0.0-beta.397

Prerequisites

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

Features

  • Teams management (list, get details, members)
  • Server management (create, validate, resources, domains)
  • Service lifecycle management (start, stop, restart)
  • Application lifecycle management (start, stop, restart, execute commands)
  • Deployment tracking
  • Private key management
  • Version and health checks

Installation

# 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:

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

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

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

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

Featured Templates

View More
Customer service
AI-Powered Product List Manager
147 625
AI Assistants
Image to text with Claude 3
150 1122
AI Characters
Sarcastic AI Chat Bot
128 1440
Customer service
Service ERP
125 756

Start your free trial

Build your solution today. No credit card required.

Sign In

Register

Reset Password

Please enter your username or email address, you will receive a link to create a new password via email.