coolify-mcp

Overview

The Coolify MCP Server provides extensive functionality for managing self-hosted PaaS through AI assistants. With 38 token-optimized tools, it enables natural language interaction for debugging, management, and deployment tasks. The server significantly reduces API response sizes (up to 99.6% reduction) while maintaining comprehensive functionality through summary responses and full-detail retrieval options.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_infrastructure_overview

  Get a high-level overview of all infrastructure (servers, projects, applications, databases, services)

  Try:Show me my infrastructure overviewTry:List all servers, projects, and applications
• diagnose_app

  Get comprehensive app diagnostics including status, logs, env vars, and deployments

  Try:Diagnose my stuartmason.co.uk appTry:Check what's wrong with my-api application
• list_applications

  List all applications with summary details (UUID, name, status)

  Try:Show me all my applicationsTry:List running applications in my project
• control

  Start, stop, or restart applications, databases, or services

  Try:Restart application abc123Try:Stop database xyz456
• application

  Create, update, or delete applications with various deployment sources

  Try:Create a new application from GitHub repo org/repoTry:Update my existing app configuration
• deploy

  Deploy an application with options for force rebuild

  Try:Deploy app abc123 with force rebuildTry:Trigger deployment for my-api
• find_issues

  Scan entire infrastructure for unhealthy resources and issues

  Try:Find any issues in my infrastructureTry:Check for unhealthy applications or services
• search_docs

  Search Coolify documentation for specific topics and configurations

  Try:Search for health check configurationTry:How to fix 502 Bad Gateway error
• projects

  Manage projects with create, list, get, update, or delete actions

  Try:Create a new project called my-appTry:List all projects
• env_vars

  Manage environment variables for applications and services

  Try:Update DATABASE_URL for app abc123Try:List env vars for service xyz456
• database

  Create or delete various types of databases (PostgreSQL, MySQL, MongoDB, etc.)

  Try:Create a PostgreSQL database for my appTry:Delete unused database xyz456
• teams

  Manage team members and access to the Coolify instance

  Try:List all team membersTry:Show me who has access to my Coolify instance

Comparable tools

Installation

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "@masonator/coolify-mcp"],
      "env": {
        "COOLIFY_ACCESS_TOKEN": "your-api-token",
        "COOLIFY_BASE_URL": "https://your-coolify-instance.com"
      }
    }
  }
}

claude mcp add coolify \
  -e COOLIFY_BASE_URL="https://your-coolify-instance.com" \
  -e COOLIFY_ACCESS_TOKEN="your-api-token" \
  -- npx @masonator/coolify-mcp@latest

FAQ

How does the server reduce token usage?

The server uses token-optimized design with consolidated tools and action parameters, reducing token usage by 85% compared to naive implementations. It also provides summary responses that are up to 99.6% smaller than full API responses.

Can I use this MCP server with authentication proxies?

Yes, the server supports custom HTTP headers for Cloudflare Zero Trust and other auth proxies through the --header parameter in the configuration.

Compare coolify-mcp with