Coolify MCP Server

Community

MCP server for managing self-hosted PaaS Coolify with 44 optimized tools.

How to install ↓ Compare GitHub source repository ↗

Category: Dev Tools #20 of 438
Stars: ★ 611 Very popular
Transport: stdio (local process)
Runtime: Node.js
Credentials: API key / credential required
License: MIT
Last commit: today
Tools: 44

68FMRS · C

Coolify MCP Server is a feature-rich and well-designed MCP server for managing Coolify self-hosted PaaS. It reduces context consumption through tool consolidation and token optimization, while providing secure defaults and human confirmation. Ideal for users who want to simplify operations with AI assistants.

Strongest · Documentation 15/20 Weakest · Reliability 10/20

Reliability

10/20

Security and permissions

15/20

Maintenance

14/20

Documentation

15/20

Setup experience

14/20

Why each score

Reliability 10/20: Source includes tests and CI workflows, indicating core paths are reproducible. However, static review cannot execute verification, and error handling/edge cases are mentioned but not fully demonstrated. Therefore, score is capped at 12.
Security and permissions 15/20: Server masks sensitive fields, confirms destructive operations by default, and relies on elicitation. No malicious behavior found. However, confirmation mechanism depends on client support and there is an escape hatch (COOLIFY_MCP_ELICITATION=off) that could reduce safety. No red flags.
Maintenance 14/20: Repository is active with regular releases, CI, and license. But no security response channel or clear governance policy visible.
Documentation 15/20: README is thorough, covering installation, auth, tool list, design principles, and security practices. Examples and troubleshooting included. Some tool parameter details rely on running with no args, possible hidden assumptions.
Setup experience 14/20: Multiple install methods (one-click, npm, JSON config) with clear client config examples. Requires Node.js/npx, but no specific runtime requirements mentioned. Static review cannot verify installation, thus not full marks.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

Developers and DevOps professionals using Coolify for self-hosted PaaS.
Teams looking to simplify daily deployment and operations with AI assistants.
Scenarios involving multiple Coolify instances.

Not for

Users without a Coolify instance.
Operations that need fully automated destructive actions without confirmation (though you can disable confirmations with COOLIFY_MCP_ELICITATION=off).
Deployments to incompatible Coolify versions (only v4.0 and above supported).

Required permissions

Requires a Coolify API access token (COOLIFY_ACCESS_TOKEN); its permissions determine what operations the MCP can perform.
Can read and modify resources such as apps, databases, services, and environment variables.
Destructive operations (e.g., delete, stop) trigger human confirmation unless disabled.

Risks and side effects

If the API token has excessive permissions, unexpected deletion or stopping of resources could occur.
Destructive operations may cause data loss, but the confirmation mechanism reduces risk.
Sensitive information (like passwords and keys) is masked by default, but enabling reveal could pose a leak risk.

Setup

Before you start

Runtime：Node.js

COOLIFY_ACCESS_TOKEN requiredsecret Coolify API token created under Coolify → Settings → API, with the read/write scopes you need.

Other optional settings (2)

COOLIFY_BASE_URL optional URL of your Coolify instance, e.g. https://your-coolify-instance.com.

COOLIFY_MCP_ELICITATION optional Set to off to disable human confirmations for destructive tools; only for clients that claim elicitation support but do not implement it.

Ensure you have a running Coolify v4 instance and an API token (Coolify → Settings → API).
For Claude Desktop: download coolify-mcp.mcpb and drag into Settings → Extensions, then enter your Coolify URL and token.
For Claude Code: run claude mcp add coolify -e COOLIFY_BASE_URL="..." -e COOLIFY_ACCESS_TOKEN="..." -- npx @masonator/coolify-mcp@latest.
For other MCP clients: add an mcpServers entry in JSON config with command npx, args ['-y', '@masonator/coolify-mcp'], and env COOLIFY_BASE_URL and COOLIFY_ACCESS_TOKEN.
Optional: add --header args for Cloudflare Access or proxy.

claude_desktop_config.json

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

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

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

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

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

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After connecting, the client should list the server's 44 tools such as get_infrastructure_overview, list_servers, and search_docs. Run get_infrastructure_overview or list_servers; returning data from your Coolify instance proves the connection works.

Troubleshooting

Ensure COOLIFY_BASE_URL and COOLIFY_ACCESS_TOKEN are set correctly.
Check that the Coolify version is v4.0 or above.
If confirmation prompts time out, increase the client's MCP tool timeout.
If you receive 403 errors, check that the token has write permissions.
If reveal: true returns empty values, you may need a token with sensitive-read scope.

Things to try

Once connected, you can ask your AI assistant things like:

Give me an overview of my infrastructure
Diagnose my stuartmason.co.uk app
Deploy application and wait for it to finish
How do I fix a 502 Bad Gateway error in Coolify?

Tools 44

get_infrastructure_overview read-only

Get an overview of the entire infrastructure.

get_mcp_version read-only

Get the version of the MCP server itself.

get_version read-only

Get the version of the Coolify instance.

system writes

System operations like health check, list resources, enable/disable API.

diagnose_app read-only

Diagnose a specific app by UUID, name, or domain.

diagnose_server read-only

Diagnose a specific server by UUID, name, or IP.

find_issues read-only

Find potential issues in the infrastructure.

restart_project_apps writes

Restart all applications in a project.

Show 36 more tools

bulk_env_update writes

Bulk update environment variables across apps.

stop_all_apps destructive

Stop all applications (destructive, requires confirmation).

redeploy_project writes

Redeploy an entire project (destructive, requires confirmation).

list_servers read-only

List all servers.

get_server read-only

Get detailed server information.

validate_server read-only

Validate server configuration.

server_resources read-only

List resources (apps, databases, etc.) on a server.

server_domains read-only

List domains on a server.

projects writes

Project management: list, get, create, update, delete.

environments writes

Environment management: list, get, create, delete.

list_applications read-only

List all applications.

get_application read-only

Get detailed application information.

application writes

Application CRUD operations and delete preview.

list_databases read-only

List all databases.

get_database read-only

Get detailed database information.

database writes

Database CRUD operations, supporting 8 types and deletion.

database_backups writes

Database backup management: CRUD schedules, executions including deletion.

list_services read-only

List all services.

get_service read-only

Get detailed service information.

service writes

Service CRUD operations, container list, update, start/stop/restart (v4.2+).

control writes

Start/stop/restart apps, databases, services.

logs read-only

Get container logs for app, database, service.

application_logs read-only

Get application logs (superseded by logs).

tags writes

Tag management: list, attach, detach, and deploy tagged resources.

env_vars writes

Environment variable CRUD and bulk update for apps, services, databases.

storages writes

Storage management: list, create, update, delete persistent/file storages.

scheduled_tasks writes

Scheduled task management: list, create, update, delete, list executions, run once.

list_deployments read-only

List deployment records.

deploy writes

Trigger deployment, optionally wait for completion and return logs.

deployment read-only

Deployment details, cancel, list per app.

private_keys writes

Private key management: list, get, create, update, delete.

github_apps writes

GitHub Apps management: list, get, create, update, delete, list repos and branches.

teams read-only

Team management: list, get members, get current team.

cloud_tokens writes

Cloud token management (Hetzner/DigitalOcean): list, get, create, update, delete, validate.

hetzner writes

Hetzner Cloud operations: list locations, server types, images, SSH keys, create server.

search_docs read-only

Full-text search across Coolify docs.

Use cases

Manage apps, databases, and services on Coolify via natural language.

Quickly diagnose issues with apps or servers and get recommendations.

Perform batch operations like restarting all apps in a project or stopping all apps.

Manage environment variables, storages, scheduled tasks, and backups.

Search Coolify documentation for help.

Supported clients

Claude Desktop

Claude Code

Cursor

Listed from the project's documentation, not tested by this site.

Overview

Coolify MCP Server is an MCP server that allows AI assistants like Claude and Cursor to manage a Coolify instance through natural language. It provides 44 consolidated tools covering infrastructure overview, diagnostics, deployments, environment variables, databases, services, backups, scheduled tasks, and more. The design focuses on token efficiency by using action-parameter tools to reduce context usage. It features secure defaults including secret masking and human confirmation for destructive operations. Compatible with Coolify v4.0 through v4.2+.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 62.9k · Tools 2 Compare with this →

NPM Sentinel MCP Server 79 · B

AI-powered NPM package analysis MCP server

★ 18 · Tools 19 Compare with this →

MartinLoop MCP Server 79 · B

An independent control layer that gives AI coding agents budgets, brakes, and receipts

★ 410 Compare with this →

GitHub MCP Server 76 · B

GitHub's official MCP server for managing repos, issues, PRs, and workflows via natural language

★ 33.5k · Tools 15 Compare with this →

Compare with other MCP servers

Source revision 34ef8c0d44fe Data synced 2026-10-12 Read the FMRS scoring method