Coolify
46 tools for deploying, diagnosing and managing a self-hosted Coolify from your AI client
- Pricing
- Open source
- Platforms
- CLI, self-hosted, API
- Runs
- Locally
- Version
- 3.10.1
- Listing updated
- 3 days ago
About Coolify
Coolify is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.
This server turns a Coolify v4 instance into something you can operate by conversation. Each tool takes an action, and calling one with no arguments lists what it accepts. It covers applications, databases across eight engines, services, projects and environments.
Its diagnostic tools are diagnose_app and diagnose_server, which take a name, domain, IP or UUID, and find_issues, which scans the whole estate. deploy waits for a terminal status and returns the log tail on failure. Destructive operations ask a human first and secrets stay masked.
It installs as an MCPB bundle for Claude Desktop, with npx locally, or as a container inside Coolify using OAuth 2.1. An npx @masonator/coolify-mcp doctor command checks the URL, token and Cloudflare Access setup. It is MIT licensed.
Install
Run in a terminal
claude mcp add coolify --env COOLIFY_ACCESS_TOKEN='<COOLIFY_ACCESS_TOKEN>' -- npx -y @masonator/coolify-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": [
"-y",
"@masonator/coolify-mcp"
],
"env": {
"COOLIFY_ACCESS_TOKEN": "<COOLIFY_ACCESS_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": [
"-y",
"@masonator/coolify-mcp"
],
"env": {
"COOLIFY_ACCESS_TOKEN": "<COOLIFY_ACCESS_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"coolify": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@masonator/coolify-mcp"
],
"env": {
"COOLIFY_ACCESS_TOKEN": "<COOLIFY_ACCESS_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": [
"-y",
"@masonator/coolify-mcp"
],
"env": {
"COOLIFY_ACCESS_TOKEN": "<COOLIFY_ACCESS_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": [
"-y",
"@masonator/coolify-mcp"
],
"env": {
"COOLIFY_ACCESS_TOKEN": "<COOLIFY_ACCESS_TOKEN>"
}
}
}
}Configuration
COOLIFY_ACCESS_TOKENYour Coolify API access tokenRequiredCOOLIFY_BASE_URLYour Coolify instance URL
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- diagnose_app
- Diagnoses an application by name, domain, IP or UUID.
- diagnose_server
- Diagnoses a server by name, domain, IP or UUID.
- find_issues
- Scans the whole estate for problems.
- logs
- Reads logs of any container.
- deploy
- Deploys and waits for a terminal status.
- control
- Starts, stops or restarts resources.
What it does
- Diagnostics
- Diagnose an app or server, or scan the estate for issues.
- Deploy and roll back
- Deploys wait for a final status and return logs on failure.
- Create resources
- Applications, eight database engines, services and projects.
- Safe by default
- Destructive actions ask a human; secrets are masked.
- Three install paths
- Desktop bundle, local npx or remote container.
- Doctor command
- Checks configuration and token before use.
Good for
- Find out why a deployment failed
- Scan a Coolify estate for problems
- Spin up a database for a new project
- Restart a service from chat
Pricing
Open source
Free, MIT licence
Prices change. Check stumason.dev before you buy.
Coolify FAQ
What do I need?
A Coolify v4 instance and an API token from Keys & Tokens.
Can it run remotely?
Yes, as a container in Coolify with OAuth 2.1; the Coolify token stays server-side.
Does it work behind Cloudflare Access?
Yes, with an Access service token set in the environment.
Is Coolify free?
Yes. Coolify is open source, so you can use and self-host it for free.
How do I add Coolify to Claude Code?
Run this command in your terminal: claude mcp add coolify --env COOLIFY_ACCESS_TOKEN='<COOLIFY_ACCESS_TOKEN>' -- npx -y @masonator/coolify-mcp
What are the best alternatives to Coolify?
The closest alternatives to Coolify are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Coolify

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools