home / mcp / coolify mcp server

Coolify MCP Server

Provides an MCP server to access Coolify resources via MCP-compatible clients and automate actions.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kof70-coolify-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/coolify-mcp-server/build/index.js"
      ],
      "env": {
        "COOLIFY_TOKEN": "your-api-token",
        "COOLIFY_TEAM_ID": "YOUR_TEAM_ID",
        "COOLIFY_BASE_URL": "https://your-coolify.com"
      }
    }
  }
}

You run an MCP server to enable direct interaction with Coolify data from any MCP-compatible AI assistant. This server exposes resources like applications, databases, servers, projects, services, teams, deployments, and private keys, and supports direct resource access via coolify:// URIs. It also handles version compatibility and rate limiting to keep interactions smooth across Coolify versions.

How to use

Install and run the MCP server locally, then connect your MCP client to it. You will configure your client to talk to the local or remote server, enabling you to list resources, create or update items, start deployments, and execute actions like deploying applications or restarting services. Use the MCP resource URIs to access data directly from your CAD-style assistant, and rely on built-in retry and compatibility logic to handle Coolify version differences.

How to install

Prerequisites you need before installing are Node.js and npm. Ensure you have a supported Node.js version installed on your machine.

# Install the MCP server globally
npm install -g coolify-mcp-server

If you prefer building from source, clone the project, install dependencies, and build the project.

git clone https://github.com/YOUR_USERNAME/coolify-mcp-server.git
cd coolify-mcp-server
npm install
npm run build

Configuration and startup notes

You must provide your Coolify instance URL and an API token to authorize MCP operations.

Additional setup and usage notes

Configure your MCP client with a stdio-based server configuration to start the Coolify MCP server locally. You can also interact with it via text prompts that reference the available resources such as applications, servers, or deployments.

Available tools

get_version

Get Coolify version information

health_check

Check API health status

list_teams

List all accessible teams

get_team

Get team details by ID

get_current_team

Get current team details

get_current_team_members

Get current team members

list_servers

List all servers

create_server

Create a new server

validate_server

Validate server connection

get_server_resources

Get server resource usage

get_server_domains

Get server domains

list_projects

List all projects

get_project

Get project details

create_project

Create a new project

list_environments

List project environments

create_environment

Create a new environment

list_applications

List all applications

get_application

Get application details

create_application

Create an application

start_application

Start an application

stop_application

Stop an application

restart_application

Restart an application

deploy_application

Deploy an application

execute_command

Execute command in container

get_application_logs

Get application logs

list_services

List all services

create_service

Create a service

start_service

Start a service

stop_service

Stop a service

restart_service

Restart a service

list_databases

List all databases

create_database

Create a database (PostgreSQL, MySQL, MongoDB, Redis)

list_deployments

List all deployments

get_deployment

Get deployment details

list_private_keys

List all SSH private keys

create_private_key

Create a new SSH private key