Coolify

This MCP server enables you to control Coolify deployment workflows through a minimal, consistent interface. You can create and manage projects, environments, servers, applications, and deployments, all from scratch, with secure defaults and streamlined tooling for building production-ready pipelines.

How to use

You interact with the Coolify MCP server by running the MCP client you choose and pointing it at your local MCP server. Use the configured transport (stdio for local usage) or switch to an HTTP transport if you run a remote MCP endpoint. You will perform common deployment tasks such as listing or creating projects, environments, and servers, then create and manage applications and trigger deployments. When you start, you can progressively build a full deployment workflow from scratch, including environment variables, SSH keys, and application configurations.

To operate safely, ensure write operations are enabled only when you intend to modify resources or trigger deployments. Secrets are masked by default in outputs, and logs are sanitized to avoid leaking sensitive information. If you need to inspect raw logs for debugging, you may enable unsafe logs only after you understand the risks.

How to install

Prerequisites you need before installing the MCP server include Node.js version 18 or higher. You also need access to a Coolify API token from your Coolify dashboard.

Install the MCP server globally using npm or run it directly with npx.

npm install -g @fndchagas/coolify-mcp
# or
npx -y @fndchagas/coolify-mcp

Configuration and start

You can run the MCP server via a local CLI configuration. The following configuration shows how to connect the MCP client to a local stdio server and provides the required environment values.

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

Security and write controls

To prevent accidental changes, you can disable all write operations. Set the environment variable COOLIFY_ALLOW_WRITE to false to ensure that create, update, delete, and deploy actions are blocked by default.

Secrets are masked in environment values and redacted in sensitive fields. Enable more aggressive redaction through log sanitization to protect your credentials in logs.

Deploy from Zero

Use this MCP workflow to deploy an application from scratch by creating and configuring all necessary resources in sequence, then triggering a deployment.

Tools Reference

Below are the tools you can use to manage your Coolify MCP server. Each tool represents a specific API operation or workflow step.

Security Features

The MCP server provides write protections, secret masking, and log sanitization to help keep your deployment data secure. Review the environment variable masking behavior and the log sanitization modes to balance visibility and security.

Development

If you are contributing to the project, clone the repository, install dependencies, and run the development server according to the standard workflow.

Available tools

listProjects

List all projects

createProject

Create a new project

updateProject

Update project name/description

deleteProject

Delete a project and all its resources

listEnvironments

List environments in a project

createEnvironment

Create a new environment

listServers

List all servers

getServer

Get server details

createServer

Create a new server

validateServer

Validate server connection

listPrivateKeys

List SSH private keys

createPrivateKey

Create a new SSH key

listGithubApps

List configured GitHub Apps

listApplications

List all applications (summarized by default)

getApplication

Get application details (secrets masked by default)

getLogs

Get application runtime logs

createPublicApplication

Create from public git repository

createPrivateGithubAppApplication

Create using GitHub App

createPrivateDeployKeyApplication

Create using SSH deploy key

createDockerfileApplication

Create from Dockerfile content

createDockerImageApplication

Create from Docker image

createDockerComposeApplication

Create from Docker Compose

updateApplication

Update application configuration

deleteApplication

Delete an application

startApplication

Start an application

stopApplication

Stop an application

restartApplication

Restart an application

listEnvs

List env vars (secrets masked by default)

createEnv

Create a new env var

upsertEnv

Create or update env var by key

updateEnv

Update an existing env var

deleteEnv

Delete an env var

deploy

Trigger a deployment

listDeployments

List running deployments

getDeployment

Get deployment status and logs

listAppDeployments

List deployments for an application

cancelDeployment

Cancel a running deployment

listDatabases

List all databases

getDatabase

Get database details

listServices

List one-click services

createService

Create a one-click service

listResources

List all resources with filtering