Coolify MCP Server

MCP server for Coolify API - enables full deployment workflows from zero to production.

Local serverstdioMIT

What is the Coolify MCP Server?

coolify-mcp is an MCP project maintained in the frndchagas/coolify-mcp repository. The maintainer describes its purpose as “MCP server for Coolify API - enables full deployment workflows from zero to production”. Read the project documentation for the complete scope.

Installation

The documented npm package is @fndchagas/coolify-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares COOLIFY_BASE_URL, COOLIFY_TOKEN, COOLIFY_ALLOW_WRITE. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
listProjectsList all projects
createProjectCreate a new project
updateProjectUpdate project name/description
deleteProjectDelete a project and all its resources
listEnvironmentsList environments in a project
createEnvironmentCreate a new environment
listServersList all servers
getServerGet server details
createServerCreate a new server
validateServerValidate server connection
listPrivateKeysList SSH private keys
createPrivateKeyCreate a new SSH key
listGithubAppsList configured GitHub Apps
listApplicationsList all applications (summarized by default)
getApplicationGet application details (secrets masked by default)
getLogsGet application runtime logs
createApplicationCreate an application; type selects the source: public, private-github-app, private-deploy-key, dockerfile, or dockerimage. Long-tail fields go in extra and…
updateApplicationUpdate application configuration
deleteApplicationDelete an application
startApplicationStart an application
stopApplicationStop an application
restartApplicationRestart an application
applicationEnvsManage application env vars: list (masked by default), create, update, upsert by key, bulk_update, delete
deployTrigger a deployment; wait: true polls to the terminal status and returns a log tail on failure
diagnoseAppDiagnose an app by UUID, name, or domain: status, recent deployments, failure log tail, runtime logs, hints
diagnoseServerDiagnose a server by UUID, name, or IP: resource status breakdown, domains, hints
listDeploymentsList running deployments
getDeploymentGet deployment status and logs
listAppDeploymentsList deployments for an application
cancelDeploymentCancel a running deployment
listDatabasesList all databases
getDatabaseGet database details
createDatabaseCreate a database; type selects the engine: postgresql, mysql, mariadb, mongodb, redis, keydb, dragonfly, clickhouse
updateDatabaseUpdate database configuration
deleteDatabaseDelete a database (volumes/configs deleted by default)
controlDatabaseStart, stop, or restart a database
databaseBackupsManage backup schedules and executions (list/create/update/delete/list_executions/delete_execution)
databaseEnvsManage database env vars (list/create/update/bulk_update/delete)
listServicesList services
getServiceGet service details (secrets masked by default)
createServiceCreate a one-click service or Docker Compose deployment
updateServiceUpdate a service
deleteServiceDelete a service
controlServiceStart, stop, or restart a service
serviceEnvsManage service env vars (list/create/update/bulk_update/delete)
storagesManage persistent volumes and file mounts for applications, databases, and services
scheduledTasksManage cron tasks for applications and services, including execution history
deletePreviewDelete a preview deployment by pull request id
teamsList teams, get current team, and list members
updateServerUpdate server configuration
deleteServerDelete a server
getServerResourcesList resources running on a server
getServerDomainsList domains configured on a server
getPrivateKeyGet SSH key metadata (key material masked by default)
updatePrivateKeyUpdate an SSH private key
deletePrivateKeyDelete an SSH private key
getGithubAppRepositoriesList repositories accessible to a GitHub App
getGithubAppBranchesList branches of a repository
getInfrastructureOverviewOne-call summary of servers, projects, applications (status breakdown), databases, services, and running deployments
restartProjectAppsRestart every application in a project or environment (asks for confirmation)
redeployProjectTrigger a deployment for every application in a project or environment (asks for confirmation)
stopAllApplicationsEmergency stop of all running applications, optionally per project (asks for confirmation, stating the blast radius)
listResourcesList all resources with filtering
searchDocsFull-text search across the official Coolify docs (bundled index, no network)
getHealthCheck that the Coolify API is up

How to install the Coolify MCP Server

{
  "mcpServers": {
    "coolify": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@fndchagas/coolify-mcp"
      ],
      "env": {
        "COOLIFY_BASE_URL": "https://coolify.example.com/api/v1",
        "COOLIFY_TOKEN": "YOUR_COOLIFY_TOKEN",
        "COOLIFY_ALLOW_WRITE": "true"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
COOLIFY_BASE_URLDeclared in the maintainer’s client configuration.Yes
COOLIFY_TOKENDeclared in the maintainer’s client configuration.Yes
COOLIFY_ALLOW_WRITEDeclared in the maintainer’s client configuration.Check documentation