Coolify MCP Server

Coolify MCP Server

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

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that provides integration with the Coolify API, enabling DevOps teams to manage Coolify deployments, applications, services, and servers through MCP tools.

  1. Prerequisites
    1. Features
      1. Installation
        1. Configuration
          1. Getting an API Token
        2. Usage
          1. In MCP Settings
          2. Available Tools
        3. License

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
            Last updated -
            4
            3
            TypeScript
            MIT License
          • -
            security
            A
            license
            -
            quality
            MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
            Last updated -
            13
            2
            TypeScript
            MIT License
          • -
            security
            -
            license
            -
            quality
            A specialized server that helps users create new Model Context Protocol (MCP) servers by providing tools and templates for scaffolding projects with various capabilities.
            Last updated -
            1
            TypeScript
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that enables users to create, check status, and get details of projects on Loveable.dev, a platform for quickly creating applications.
            Last updated -
            JavaScript
            ISC License
            • Apple

          View all related MCP servers

          ID: 7l1wc3mnnj