Coolify

You can run a Coolify MCP Server to bridge your Coolify instance with MCP tools, enabling centralized management of teams, projects, environments, services, and deployments from your MCP client. This server authenticates with Coolify and exposes a consistent set of MCP endpoints for your workflows.

How to use

Start by installing and running the MCP server, then connect your MCP client to it using the provided command. Once connected, you can manage teams, create and retrieve projects and environments, oversee services and applications, and track deployments through MCP operations. Use the server to orchestrate tasks across your Coolify instance from a single control plane.

How to install

Prerequisites you need before installing include Node.js 18 or higher and access to your Coolify instance with a valid API token.

npm install -g coolify-mcp-server

# Or run directly with npx
npx coolify-mcp-server

Configuration and usage notes

Configure your MCP client to use the Coolify MCP Server. You will provide the Coolify base URL and API token so the server can communicate with your Coolify instance.

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "your-coolify-url",
        "COOLIFY_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Environment specifics for Windows users

If you are configuring on Windows, you can start the server using a command prompt with the following settings.

{
  "mcpServers": {
    "coolify": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "coolify-mcp-server"
      ],
      "env": {
        "COOLIFY_BASE_URL": "your-coolify-url",
        "COOLIFY_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Notes on prerequisites and tokens

Prepare your Coolify API token with read, write, and deploy permissions as required for your workflows.

Troubleshooting

If the server fails to start, verify that the COOLIFY_BASE_URL and COOLIFY_TOKEN values are correct and that Node.js 18+ is installed. Check for network access to your Coolify instance and ensure the API token has adequate permissions. If you encounter authentication errors, regenerate the API token and update your environment variables accordingly.

Security considerations

Keep your API token confidential. Do not commit tokens to version control, and rotate tokens periodically according to your security policy.

Available tools

get_version

Retrieve the Coolify server version information

health_check

Check the health status of the Coolify API

list_teams

List all teams in Coolify

get_team

Get details of a specific team

get_current_team

Get details of the current team in context

get_current_team_members

List members of the current team

list_servers

List all managed Coolify servers

create_server

Create a new Coolify server configuration

validate_server

Validate a server configuration before use

get_server_resources

Query resource usage for a server

get_server_domains

Fetch domains associated with a server

list_projects

List all projects in Coolify

get_project

Get details of a specific project

create_project

Create a new project in Coolify

list_environments

List environments within a project

create_environment

Create a new environment inside a project

list_services

List all services

create_service

Create a new service

start_service

Start a service

stop_service

Stop a service

restart_service

Restart a service

list_applications

List all applications

create_application

Create a new application

start_application

Start an application

stop_application

Stop an application

restart_application

Restart an application

execute_command_application

Execute a command inside an application container

get_application_logs

Retrieve logs for an application

list_deployments

List all deployments

get_deployment

Get deployment details

list_private_keys

List all private keys

create_private_key

Create a new private key