Model Context Protocol

Manage Coolify
through AI

45-tool MCP server for Coolify. Control servers, applications, databases, deployments and diagnostics — all through natural language.

Get on npm View on GitHub
// .mcp.json or ~/.claude/settings.json
{
  "mcpServers": {
    "coolify": {
      "command": "bunx",
      "args": ["@jurislm/coolify-mcp@latest"],
      "env": {
        "COOLIFY_TOKEN": "your-api-token",
        "COOLIFY_URL": "https://your-coolify-instance.com"
      }
    }
  }
}
45
MCP Tools
85%
Token reduction vs raw API
MIT
License
v3
Latest major

Why coolify-mcp

Purpose-built for AI-assisted infrastructure management on Coolify

⚡

Token-optimized

List endpoints return compact summaries. Full details only when you ask. 85% fewer tokens than raw API.

🔍

Smart diagnostics

diagnose_app, diagnose_server, and find_issues surface problems in one natural language query.

🛡️

Input validation

UUID allow-lists, size caps on private keys and cloud-init scripts, SSRF and path traversal prevention.

🔁

Batch operations

Restart a project, bulk-update env vars, or emergency-stop all apps — single tool calls.

🔐

Read-before-write actions

Destructive operations include built-in confirmation hints, reducing accidental changes.

🌐

Full API coverage

Servers, apps, databases, deployments, env vars, private keys, GitHub Apps, storage, scheduled tasks, and more.

45 tools across 20 categories

Everything you need to manage a Coolify instance

🏗️ Infrastructure 5
Overview, health check, API & MCP version, API control
🔎 Diagnostics 3
App/server diagnostics, scan all infra for issues
🖥️ Servers 6
List, get, create, update, delete, validate
📦 Applications 4
List, get, CRUD, logs; 6 app create types
🗄️ Databases 5
PostgreSQL, MySQL, Redis, MongoDB + backups
⚙️ Services 3
Docker Compose service management
⏯️ Control 1
Start, stop, restart app/db/service
🚀 Deployments 3
Deploy by tag/UUID, PR previews, cancel
🔧 Env Vars 1
CRUD & bulk upsert across app/db/service
🌍 Projects 1
List, get, create, update, delete
🌿 Environments 1
List, get, create, delete per project
🔑 Private Keys 1
SSH key lifecycle management
🐙 GitHub Apps 1
Manage GitHub App integrations
🕐 Scheduled Tasks 1
Cron jobs + execution history
💾 Storages 1
Persistent volumes for app/db/service
☁️ Hetzner 1
Create Hetzner Cloud servers from Claude
📦 Batch Ops 4
Restart project, bulk env, stop all, redeploy
👥 Teams 1
Team and member information
☁️ Cloud Tokens 1
Hetzner & DigitalOcean API tokens
🔎 Resources 1
Search across all resource types

Setup

Add to your MCP config and start managing Coolify through Claude

1. Get your API token from Coolify → Settings → API

2. Add to .mcp.json: 

{
  "mcpServers": {
    "coolify": {
      "command": "bunx",
      "args": ["@jurislm/coolify-mcp@latest"],
      "env": {
        "COOLIFY_TOKEN": "your-api-token",
        "COOLIFY_URL": "https://your-coolify-instance.com"
      }
    }
  }
}

3. Restart Claude Code. You now have 45 Coolify tools available.