logo
Marketplace
My Favorites
Submit
Coolify MCP Server
W

wrediam

Enables comprehensive Coolify infrastructure management by exposing tools for creating, deploying, and tracking servers, applications, and team resources with robust operational capabilities.

Content

Tools

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

get_version

Get Coolify version information. Returns the current version of the Coolify instance.

health_check

Check Coolify API health status. Note: This endpoint may not be available in all Coolify versions, including the current version (4.0.0-beta.397).

list_teams

List all teams the authenticated user has access to. Use this to get team UUIDs needed for other operations.

get_team

Get details of a specific team. Requires a team ID obtained from list_teams.

get_current_team

Get details of the currently authenticated team. This is the team associated with your API token.

get_current_team_members

Get a list of all members in the currently authenticated team. Shows who has access to team resources.

list_servers

List all servers registered in your Coolify instance. Use this to get server UUIDs needed for other operations.

create_server

Create a new server in Coolify. Requires SSH access details and a private key for authentication.

validate_server

Validate a server's configuration and connectivity. Use this to verify server setup and troubleshoot connection issues.

get_server_resources

Get a list of applications and services running on a server. This provides an overview of all resources deployed on the specified server.

get_server_domains

Get a list of domains configured for a server. These domains are used for routing traffic to applications and services.

list_services

List all services across your Coolify instance. Services are containerized applications running on your servers.

create_service

Create a new service on a specified server. Services are containerized applications that run on your Coolify servers.

start_service

Start a previously created service. This will initialize the service container and make it accessible.

stop_service

Stop a running service. This will gracefully shut down the service container.

restart_service

Restart a service by stopping and starting it again. Useful for applying configuration changes or recovering from issues.

list_applications

List all applications across your Coolify instance. Applications are deployable units sourced from Git repositories.

create_application

Create a new application in Coolify. Applications are deployable units that can be sourced from Git repositories.

start_application

Start a previously created application. This will initialize the application container and make it accessible.

stop_application

Stop a running application. This will gracefully shut down the application container.

restart_application

Restart an application by stopping and starting it again. Useful for applying configuration changes or recovering from issues.

execute_command_application

Execute a command inside a running application container. Useful for debugging, maintenance, or running one-off tasks. Note: This endpoint may not be available in all Coolify versions, including the current version (4.0.0-beta.397).

list_deployments

List all deployments across your Coolify instance. Deployments represent the history of application and service deployments.

get_deployment

Get detailed information about a specific deployment. Use this to monitor deployment status and troubleshoot issues.

list_private_keys

List all SSH private keys stored in Coolify. These keys are used for server authentication and Git repository access.

create_private_key

Create a new SSH private key in Coolify for server authentication or Git repository access.

Connect MCP Server