Coolify

You run a Coolify MCP server to let AI assistants manage your Coolify infrastructure and perform actions across servers, projects, applications, databases, services, and more. This MCP server provides a consistent interface you can connect to from your AI assistant or client, enabling automated control and orchestration of your Coolify resources.

How to use

You connect an MCP client to the Coolify MCP server using the stdio command flow. The server runs locally via a command like npx coolify-mcp-tools, and you provide the necessary environment values to authorize access to your Coolify instance. Once connected, you can ask your MCP-enabled assistant to list resources, create and manage servers, projects, applications, databases, services, and more. Use plain, natural language prompts such as “list all servers in my production project” or “deploy this application to my staging environment,” and the MCP will translate your requests into Coolify operations.

How to install

Prerequisites: you need Node.js and npm installed on your system. If you do not have them, install Node.js from the official site which will include npm.

Option 1: Quick, recommended approach using npx. This fetches and runs the MCP tools directly without a global install.

npx coolify-mcp-tools

Option 2: Global installation for repeated use. Install the MCP tools globally and run them from anywhere.

npm install -g coolify-mcp-tools
coolify-mcp

Option 3: From source. If you prefer to build from source, clone the repository, install dependencies, and build.

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

Configuration and startup notes

Your MCP client needs to know how to reach your Coolify instance and must be authorized. Provide these environment variables when you configure the MCP client.

COOLIFY_BASE_URL= https://your-coolify-instance.com
COOLIFY_ACCESS_TOKEN= your-api-token-here

Available tools

list_servers

List all Coolify servers

get_server

Get details of a specific server

create_server

Create a new server in Coolify

update_server

Update server configuration

delete_server

Delete a server

get_server_resources

Fetch resources running on a server

get_server_domains

Retrieve domains configured on a server

validate_server

Validate server connection

list_projects

List all projects in Coolify

get_project

Get details of a specific project

create_project

Create a new project

update_project

Update project configuration

delete_project

Delete a project

get_project_environment

Get environment details for a project

list_project_environments

List environments for projects

create_project_environment

Create a new environment for a project

delete_project_environment

Delete an environment for a project

list_applications

List all applications across projects

get_application

Get details of an application

create_public_application

Create an application from a public Git repo

create_private_ghapp_application

Create an application from a private GitHub App repo

create_private_deploykey_application

Create an application from a private repo with a deploy key

create_dockerfile_application

Create an application from a Dockerfile

create_dockerimage_application

Create an application from a Docker image

create_dockercompose_application

Create an application from Docker Compose

update_application

Update application configuration

delete_application

Delete an application

start_application

Start an application

stop_application

Stop an application

restart_application

Restart an application

deploy_application

Deploy an application by tag or UUID

get_application_logs

Retrieve logs for an application

execute_application_command

Execute a command inside an application's container

list_application_envs

List environment variables for an application

create_application_env

Create an environment variable for an application

update_application_env

Update an environment variable for an application

bulk_update_application_envs

Bulk update environment variables for an application

delete_application_env

Delete an environment variable from an application

list_databases

List all databases in Coolify

get_database

Get details of a database

update_database

Update a database

delete_database

Delete a database

create_postgres_database

Create a PostgreSQL database

create_mysql_database

Create a MySQL database

create_mariadb_database

Create a MariaDB database

create_mongodb_database

Create a MongoDB database

create_redis_database

Create a Redis database

create_keydb_database

Create a KeyDB database

create_clickhouse_database

Create a Clickhouse database

create_dragonfly_database

Create a Dragonfly database

start_database

Start a database

stop_database

Stop a database

restart_database

Restart a database

list_database_backups

List backup configurations for databases

create_database_backup

Create a database backup configuration

update_database_backup

Update a database backup configuration

delete_database_backup

Delete a database backup configuration

list_backup_executions

List backup executions for databases

delete_backup_execution

Delete a backup execution

list_services

List all one-click services

get_service

Get service details

create_service

Create a one-click service (WordPress, n8n, etc.)

update_service

Update a service

delete_service

Delete a service

start_service

Start a service

stop_service

Stop a service

restart_service

Restart a service

list_service_envs

List environment variables for a service

create_service_env

Create an environment variable for a service

update_service_env

Update an environment variable for a service

bulk_update_service_envs

Bulk update environment variables for a service

delete_service_env

Delete an environment variable from a service

list_github_apps

List GitHub App integrations

create_github_app

Create a GitHub App integration

update_github_app

Update a GitHub App

delete_github_app

Delete a GitHub App

list_github_app_repositories

List repositories accessible by the GitHub App

list_github_app_branches

List branches for a repository accessed by the GitHub App

list_private_keys

List all private keys

get_private_key

Get private key details

create_private_key

Create a new private key

update_private_key

Update a private key

delete_private_key

Delete a private key

list_teams

List all teams

get_team

Get details of a team

get_team_members

Get members of a team

get_current_team

Get the current authenticated team

get_current_team_members

Get members of the current authenticated team

list_deployments

List running deployments

get_deployment

Get deployment details

get_deployments_by_application

Get deployments for a specific application

cancel_deployment

Cancel a deployment

deploy

Deploy by tag or UUID

list_resources

List all resources in Coolify

get_version

Get Coolify version information

healthcheck

Check API health status

enable_api

Enable Coolify API

disable_api

Disable Coolify API