Coolify MCP server

Enables comprehensive Coolify infrastructure management by exposing tools for creating, deploying, and tracking servers, applications, and team resources with robust operational capabilities.
Back to servers
Setup instructions
Provider
wrediam
Release date
Mar 18, 2025
Language
TypeScript
Package
Stats
1.2K downloads
15 stars

The Coolify MCP Server acts as a bridge between MCP tools and the Coolify API, allowing you to manage and interact with your Coolify instances through the Model Context Protocol. This server provides comprehensive control over teams, services, applications, and server resources.

Prerequisites

Before installing the Coolify MCP Server, ensure you have:

  • Node.js 18 or higher
  • Your Coolify Base URL
  • A Coolify API token with appropriate permissions

Installation

You can install and use the Coolify MCP Server in two ways:

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

# Or use with npx without installing
npx coolify-mcp-server

Configuration

The server requires two environment variables to function properly:

  • COOLIFY_BASE_URL: Your Coolify instance URL
  • COOLIFY_TOKEN: Your Coolify API token

Obtaining an API Token

Follow these steps to get your Coolify API token:

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

Integration with MCP

To use the Coolify MCP Server with your MCP tools, add the following configuration to your MCP settings:

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

Windows Command Line users should use this configuration instead:

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

The Coolify MCP Server provides a wide range of functionality organized by category:

Version & Health

  • get_version: Retrieve Coolify version information
  • health_check: Verify Coolify API health status

Teams Management

  • list_teams: Display all teams
  • get_team: Get detailed information about a specific team
  • get_current_team: View current team details
  • get_current_team_members: List current team members

Server Management

  • list_servers: Display all servers
  • create_server: Set up a new server
  • validate_server: Validate server configuration
  • get_server_resources: Monitor server resource usage
  • get_server_domains: View server domains

Service Management

  • list_services: Display all services
  • create_service: Set up a new service
  • start_service: Launch a service
  • stop_service: Halt a service
  • restart_service: Reboot a service

Application Management

  • list_applications: Display all applications
  • create_application: Set up a new application
  • start_application: Launch an application
  • stop_application: Halt an application
  • restart_application: Reboot an application
  • execute_command_application: Run commands within application containers

Deployment Tracking

  • list_deployments: Display all deployments
  • get_deployment: View detailed deployment information

Private Key Management

  • list_private_keys: Display all private keys
  • create_private_key: Generate a new private key

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

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

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

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

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

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

3. Restart Claude Desktop for the changes to take effect

Want to 10x your AI skills?

Get a free account and learn to code + market your apps using AI (with or without vibes!).

Nah, maybe later