mcp-coolify

coolify-mcp

MCP server for managing Coolify instances. Control applications, databases, services, servers, and more directly from Claude or any MCP-compatible client.

74 tools | 7 resources | 4 prompts

Installation

Claude Code

claude mcp add coolify \
  -e COOLIFY_API_URL=http://your-server:8000/api/v1 \
  -e COOLIFY_TOKEN=your-token \
  -- npx coolify-mcp

Codex

codex mcp add coolify \
  --env COOLIFY_API_URL=http://your-server:8000/api/v1 \
  --env COOLIFY_TOKEN=your-token \
  -- npx coolify-mcp

Other MCP clients

COOLIFY_API_URL=http://your-server:8000/api/v1 \
COOLIFY_TOKEN=your-token \
npx coolify-mcp

From source

git clone https://github.com/0xtlt/coolify-mcp
cd coolify-mcp && bun install
COOLIFY_API_URL=... COOLIFY_TOKEN=... bun run src/index.ts

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "coolify": {
      "command": "bun",
      "args": ["run", "/path/to/coolify-mcp/src/index.ts"],
      "env": {
        "COOLIFY_API_URL": "http://your-server:8000/api/v1",
        "COOLIFY_TOKEN": "your-token"
      }
    }
  }
}

Get your API token

Coolify dashboard: Keys & Tokens > API tokens

Available Tools

Applications (8)

Tool	Description
coolify_list_applications	List all applications (summary)
coolify_get_application	Get application details
coolify_create_application	[WRITE] Create from public/private repo, Dockerfile, or Docker image
coolify_update_application	[WRITE] Update application config
coolify_start_application	[WRITE] Start a stopped application
coolify_stop_application	[DESTRUCTIVE] Stop an application
coolify_restart_application	[DESTRUCTIVE] Restart an application
coolify_delete_application	[DESTRUCTIVE] Delete an application

Databases (11)

Tool	Description
coolify_list_databases	List all databases (summary)
coolify_get_database	Get database details
coolify_create_database	[WRITE] Create PostgreSQL, MySQL, MariaDB, MongoDB, Redis, etc.
coolify_update_database	[WRITE] Update database config
coolify_list_database_backups	List backups for a database
coolify_create_database_backup	[WRITE] Create a database backup
coolify_delete_database_backup	[DESTRUCTIVE] Delete a scheduled backup config
coolify_start_database	[WRITE] Start a stopped database
coolify_stop_database	[DESTRUCTIVE] Stop a database
coolify_restart_database	[DESTRUCTIVE] Restart a database
coolify_delete_database	[DESTRUCTIVE] Delete a database

Services (8)

Tool	Description
coolify_list_services	List all services (summary)
coolify_get_service	Get service details
coolify_create_service	[WRITE] Create a one-click Docker Compose service
coolify_update_service	[WRITE] Update service config
coolify_start_service	[WRITE] Start a stopped service
coolify_stop_service	[DESTRUCTIVE] Stop a service
coolify_restart_service	[DESTRUCTIVE] Restart a service
coolify_delete_service	[DESTRUCTIVE] Delete a service

Servers (8)

Tool	Description
coolify_list_servers	List all servers (summary)
coolify_get_server	Get server details
coolify_create_server	[WRITE] Add a new server (requires SSH key)
coolify_update_server	[WRITE] Update server config
coolify_validate_server	Check SSH connectivity and Docker
coolify_get_server_resources	List all resources on a server
coolify_get_server_domains	List all domains on a server
coolify_delete_server	[DESTRUCTIVE] Delete a server

Private Keys (5)

Tool	Description
coolify_list_private_keys	List all SSH private keys (summary)
coolify_get_private_key	Get private key details
coolify_create_private_key	[WRITE] Create a new SSH key
coolify_update_private_key	[WRITE] Update an SSH key
coolify_delete_private_key	[DESTRUCTIVE] Delete an SSH key

Projects & Environments (9)

Tool	Description
coolify_list_projects	List all projects (summary)
coolify_get_project	Get project details
coolify_create_project	[WRITE] Create a new project
coolify_update_project	[WRITE] Update a project
coolify_delete_project	[DESTRUCTIVE] Delete a project
coolify_list_environments	List environments in a project
coolify_get_environment	Get environment details
coolify_create_environment	[WRITE] Create an environment
coolify_delete_environment	[DESTRUCTIVE] Delete an environment

Deployments (5)

Tool	Description
coolify_list_deployments	List currently running/queued deployments
coolify_list_application_deployments	List deployment history for an application (with pagination)
coolify_get_deployment	Get deployment details
coolify_trigger_deploy	[WRITE] Trigger a deployment
coolify_cancel_deployment	[WRITE] Cancel a running deployment

Application Env Vars (4)

Tool	Description
coolify_list_envs	List env vars for an application
coolify_create_env	[WRITE] Create an env var
coolify_update_envs_bulk	[WRITE] Bulk update env vars
coolify_delete_env	[DESTRUCTIVE] Delete an env var

Service Env Vars (4)

Tool	Description
coolify_list_service_envs	List env vars for a service
coolify_create_service_env	[WRITE] Create a service env var
coolify_update_service_envs_bulk	[WRITE] Bulk update service env vars
coolify_delete_service_env	[DESTRUCTIVE] Delete a service env var

Database Env Vars (4)

Tool	Description
coolify_list_database_envs	List env vars for a database
coolify_create_database_env	[WRITE] Create a database env var
coolify_update_database_envs_bulk	[WRITE] Bulk update database env vars
coolify_delete_database_env	[DESTRUCTIVE] Delete a database env var

Logs (3)

Tool	Description
coolify_get_logs	Get application logs with filtering
coolify_get_database_logs	Get database logs with filtering
coolify_get_service_logs	Get service logs with filtering

System (2)

Tool	Description
coolify_get_version	Get Coolify instance version
coolify_healthcheck	Check if Coolify is healthy

Teams (3)

Tool	Description
coolify_list_teams	List all teams
coolify_get_current_team	Get current authenticated team
coolify_get_team_members	List members of a team

Available Resources

URI	Description
coolify://applications	List of all applications
coolify://databases	List of all databases
coolify://services	List of all services
coolify://servers	List of all servers
coolify://deployments	List of all deployments
coolify://projects	List of all projects
coolify://private-keys	List of all SSH private keys

Available Prompts

Prompt	Description
troubleshoot_deployment	Step-by-step guide to debug a failed deployment
infrastructure_overview	Get a complete overview of all infrastructure
deploy_application	Guided workflow to deploy an application
setup_new_application	Guided workflow to create and configure a new app

Safety Modes

Variable	Description
COOLIFY_READONLY=true	Only read operations available (list, get, logs)
COOLIFY_REQUIRE_CONFIRM=true	Destructive operations require confirm: true

Log Filtering

The coolify_get_logs, coolify_get_database_logs, and coolify_get_service_logs tools support:

• level: Minimum log level (debug, info, warn, error, fatal)
• since/until: ISO 8601 timestamps for time range
• search: Case-insensitive text search
• limit: Max entries (default 100)
• tail: Get most recent logs

Environment Variables

Variable	Required	Description
COOLIFY_API_URL	Yes	Coolify API URL (e.g. http://your-server:8000/api/v1)
COOLIFY_TOKEN	Yes	Bearer token from Coolify dashboard
COOLIFY_TIMEOUT	No	Request timeout in ms (default: 30000)
COOLIFY_READONLY	No	Read-only mode (default: false)
COOLIFY_REQUIRE_CONFIRM	No	Require confirmation for destructive ops (default: false)
DEBUG	No	Enable debug logging (default: false)

Development

bun install              # Install dependencies
bun run dev              # Watch mode
bun run inspect          # MCP Inspector
bun run check            # Lint + typecheck + test
bun test                 # Run tests only

License

MIT