frndchagas avatar

Coolify MCP

frndchagas/coolify-mcp

Connects Claude directly to the Coolify API for managing self-hosted deployments. You get 38 tools covering the full workflow: create projects and environments, provision servers, deploy six application types (public git, GitHub App, Docker Compose, etc.), manage environment variables with secret masking, and control deployments. Built for going from zero to production without leaving your AI conversation. Includes write protection toggles and log sanitization to keep credentials out of responses. If you're running Coolify and want to script deploys or debug apps through Claude, this gives you complete API coverage. Requires a Coolify instance and API token.

GitHub stars
4
tools
65
auth
Secret needed
transport
STDIO
env vars
6
last updated
Aug 24, 2026

Tools

65 tools

Public tool metadata for what this MCP can expose to an agent.

listProjectsList all projects

List all projects

No parameter schema in public metadata yet.

createProjectCreate a new project

Create a new project

No parameter schema in public metadata yet.

updateProjectUpdate project name/description

Update project name/description

No parameter schema in public metadata yet.

deleteProjectDelete a project and all its resources

Delete a project and all its resources

No parameter schema in public metadata yet.

listEnvironmentsList environments in a project

List environments in a project

No parameter schema in public metadata yet.

createEnvironmentCreate a new environment

Create a new environment

No parameter schema in public metadata yet.

listServersList all servers

List all servers

No parameter schema in public metadata yet.

getServerGet server details

Get server details

No parameter schema in public metadata yet.

createServerCreate a new server

Create a new server

No parameter schema in public metadata yet.

validateServerValidate server connection

Validate server connection

No parameter schema in public metadata yet.

listPrivateKeysList SSH private keys

List SSH private keys

No parameter schema in public metadata yet.

createPrivateKeyCreate a new SSH key

Create a new SSH key

No parameter schema in public metadata yet.

listGithubAppsList configured GitHub Apps

List configured GitHub Apps

No parameter schema in public metadata yet.

listApplicationsList all applications (summarized by default)

List all applications (summarized by default)

No parameter schema in public metadata yet.

getApplicationGet application details (secrets masked by default)

Get application details (secrets masked by default)

No parameter schema in public metadata yet.

getLogsGet application runtime logs

Get application runtime logs

No parameter schema in public metadata yet.

createApplicationCreate an application; type selects the source: public, private-github-app, private-deploy-key, dockerfile, or dockerimage.

Create an application; type selects the source: public, private-github-app, private-deploy-key, dockerfile, or dockerimage.

No parameter schema in public metadata yet.

updateApplicationUpdate application configuration

Update application configuration

No parameter schema in public metadata yet.

deleteApplicationDelete an application

Delete an application

No parameter schema in public metadata yet.

startApplicationStart an application

Start an application

No parameter schema in public metadata yet.

stopApplicationStop an application

Stop an application

No parameter schema in public metadata yet.

restartApplicationRestart an application

Restart an application

No parameter schema in public metadata yet.

applicationEnvsManage application env vars: list (masked by default), create, update, upsert by key, bulk_update, delete

Manage application env vars: list (masked by default), create, update, upsert by key, bulk_update, delete

No parameter schema in public metadata yet.

deployTrigger a deployment; wait: true polls to the terminal status and returns a log tail on failure

Trigger a deployment; wait: true polls to the terminal status and returns a log tail on failure

No parameter schema in public metadata yet.

diagnoseAppDiagnose an app by UUID, name, or domain: status, recent deployments, failure log tail, runtime logs, hints

Diagnose an app by UUID, name, or domain: status, recent deployments, failure log tail, runtime logs, hints

No parameter schema in public metadata yet.

diagnoseServerDiagnose a server by UUID, name, or IP: resource status breakdown, domains, hints

Diagnose a server by UUID, name, or IP: resource status breakdown, domains, hints

No parameter schema in public metadata yet.

listDeploymentsList running deployments

List running deployments

No parameter schema in public metadata yet.

getDeploymentGet deployment status and logs

Get deployment status and logs

No parameter schema in public metadata yet.

listAppDeploymentsList deployments for an application

List deployments for an application

No parameter schema in public metadata yet.

cancelDeploymentCancel a running deployment

Cancel a running deployment

No parameter schema in public metadata yet.

listDatabasesList all databases

List all databases

No parameter schema in public metadata yet.

getDatabaseGet database details

Get database details

No parameter schema in public metadata yet.

createDatabaseCreate a database; type selects the engine: postgresql, mysql, mariadb, mongodb, redis, keydb, dragonfly, clickhouse

Create a database; type selects the engine: postgresql, mysql, mariadb, mongodb, redis, keydb, dragonfly, clickhouse

No parameter schema in public metadata yet.

updateDatabaseUpdate database configuration

Update database configuration

No parameter schema in public metadata yet.

deleteDatabaseDelete a database (volumes/configs deleted by default)

Delete a database (volumes/configs deleted by default)

No parameter schema in public metadata yet.

controlDatabaseStart, stop, or restart a database

Start, stop, or restart a database

No parameter schema in public metadata yet.

databaseBackupsManage backup schedules and executions (list/create/update/delete/list_executions/delete_execution)

Manage backup schedules and executions (list/create/update/delete/list_executions/delete_execution)

No parameter schema in public metadata yet.

databaseEnvsManage database env vars (list/create/update/bulk_update/delete)

Manage database env vars (list/create/update/bulk_update/delete)

No parameter schema in public metadata yet.

listServicesList services

List services

No parameter schema in public metadata yet.

getServiceGet service details (secrets masked by default)

Get service details (secrets masked by default)

No parameter schema in public metadata yet.

createServiceCreate a one-click service or Docker Compose deployment

Create a one-click service or Docker Compose deployment

No parameter schema in public metadata yet.

updateServiceUpdate a service

Update a service

No parameter schema in public metadata yet.

deleteServiceDelete a service

Delete a service

No parameter schema in public metadata yet.

controlServiceStart, stop, or restart a service

Start, stop, or restart a service

No parameter schema in public metadata yet.

serviceEnvsManage service env vars (list/create/update/bulk_update/delete)

Manage service env vars (list/create/update/bulk_update/delete)

No parameter schema in public metadata yet.

storagesManage persistent volumes and file mounts for applications, databases, and services

Manage persistent volumes and file mounts for applications, databases, and services

No parameter schema in public metadata yet.

scheduledTasksManage cron tasks for applications and services, including execution history

Manage cron tasks for applications and services, including execution history

No parameter schema in public metadata yet.

deletePreviewDelete a preview deployment by pull request id

Delete a preview deployment by pull request id

No parameter schema in public metadata yet.

teamsList teams, get current team, and list members

List teams, get current team, and list members

No parameter schema in public metadata yet.

updateServerUpdate server configuration

Update server configuration

No parameter schema in public metadata yet.

deleteServerDelete a server

Delete a server

No parameter schema in public metadata yet.

getServerResourcesList resources running on a server

List resources running on a server

No parameter schema in public metadata yet.

getServerDomainsList domains configured on a server

List domains configured on a server

No parameter schema in public metadata yet.

getPrivateKeyGet SSH key metadata (key material masked by default)

Get SSH key metadata (key material masked by default)

No parameter schema in public metadata yet.

updatePrivateKeyUpdate an SSH private key

Update an SSH private key

No parameter schema in public metadata yet.

deletePrivateKeyDelete an SSH private key

Delete an SSH private key

No parameter schema in public metadata yet.

getGithubAppRepositoriesList repositories accessible to a GitHub App

List repositories accessible to a GitHub App

No parameter schema in public metadata yet.

getGithubAppBranchesList branches of a repository

List branches of a repository

No parameter schema in public metadata yet.

getInfrastructureOverviewOne-call summary of servers, projects, applications (status breakdown), databases, services, and running deployments

One-call summary of servers, projects, applications (status breakdown), databases, services, and running deployments

No parameter schema in public metadata yet.

restartProjectAppsRestart every application in a project or environment (asks for confirmation)

Restart every application in a project or environment (asks for confirmation)

No parameter schema in public metadata yet.

redeployProjectTrigger a deployment for every application in a project or environment (asks for confirmation)

Trigger a deployment for every application in a project or environment (asks for confirmation)

No parameter schema in public metadata yet.

stopAllApplicationsEmergency stop of all running applications, optionally per project (asks for confirmation, stating the blast radius)

Emergency stop of all running applications, optionally per project (asks for confirmation, stating the blast radius)

No parameter schema in public metadata yet.

listResourcesList all resources with filtering

List all resources with filtering

No parameter schema in public metadata yet.

searchDocsFull-text search across the official Coolify docs (bundled index, no network)

Full-text search across the official Coolify docs (bundled index, no network)

No parameter schema in public metadata yet.

getHealthCheck that the Coolify API is up

Check that the Coolify API is up

No parameter schema in public metadata yet.

Sponsors

Configuration

COOLIFY_BASE_URL*

Coolify API base URL.

COOLIFY_TOKEN*secret

Coolify API token.

COOLIFY_STRICT_VERSIONdefault: false

Fail on version mismatch.

COOLIFY_ALLOW_WRITEdefault: true

Enable write operations.

COOLIFY_ALLOW_UNSAFE_LOGSdefault: false

Allow raw logs without redaction (unsafe).

COOLIFY_OPENAPI_REF

Override OpenAPI version ref (optional).

Readme

coolify-mcp

npm version npm downloads license node version typescript CI Glama score

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

coolify-mcp demo

Targets the Coolify v4.3.10 API. Types and schemas are generated directly from Coolify's official OpenAPI spec, so tool inputs always match what the API actually accepts.

Features


View the full README on GitHub

Details

Repository
github.com/frndchagas/coolify-mcp
Website
github.com/frndchagas/coolify-mcp
Package
@fndchagas/coolify-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from frndchagas