Coolify

You can run a self-hosted MCP server to manage Coolify infrastructure, applications, databases, services, and more through familiar MCP client workflows. This server connects to your Coolify instance and exposes a rich set of operations to automate and orchestrate your platform.

How to use

You interact with the Coolify MCP server by configuring an MCP client to run the server package and by using the available tools to manage teams, servers, projects, applications, databases, services, deployments, and environment variables. The server supports both remote HTTP-based interactions and local stdio execution, allowing you to run commands directly from your environment.

How to install

Prerequisites you need before installation are Node.js 18 or higher and access to your Coolify instance (base URL and API token). Install the MCP server package globally or run it with npx to start using it right away.

# Install globally
npm install -g @pashvc/mcp-server-coolify

# Or use with npx
npx @pashvc/mcp-server-coolify

Configuration and usage examples

Configure the MCP client to load the Coolify MCP server by specifying environment variables for your Coolify base URL and API token. The examples below show how to set up the MCP server in your client configuration.

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

Security and tokens

Protect your Coolify API token and only grant the minimum necessary permissions (read, write, deploy) for the MCP server to operate. Store the token securely and rotate it periodically.

If you are using Windows command line, you can adapt the command to start the MCP server in a Windows environment.

Available tools and operations overview

The server exposes a wide set of tools to manage every aspect of your Coolify setup. You can list, view, create, update, and delete entities like teams, servers, projects, applications, databases, services, environment variables, deployments, and private keys. You can also trigger deployments, fetch logs, and perform health checks.

Troubleshooting

If you encounter issues, verify that COOLIFY_BASE_URL and COOLIFY_TOKEN are correctly set and that the token has the required permissions. Ensure your Coolify instance is reachable from the MCP server host. For 404 errors, remember that some endpoints may vary between Coolify versions and the MCP server adapts to these differences automatically.

Notes

The server supports TypeScript with strong typing, comprehensive error handling, and integration with debugging tools to streamline development and troubleshooting. You can run tests to validate connectivity and behavior in integration environments.

Available tools

list_teams

List all teams available in Coolify and provide basic details such as team name and ID.

get_team

Fetch detailed information about a specific team by its identifier.

get_current_team

Retrieve information about the currently active team in the session.

get_current_team_members

List members of the current team.

list_servers

List all configured servers and their statuses.

create_server

Create a new server entry with connection details.

validate_server

Validate the server configuration to ensure connectivity.

get_server_resources

Fetch system resources for a given server.

get_server_domains

Retrieve domains configured on a server.

list_projects

List all projects within the Coolify environment.

get_project

Get detailed information about a specific project.

create_project

Create a new project with provided settings.

update_project

Update settings for an existing project.

delete_project

Delete a project and its associated resources.

list_applications

List all applications within a project or environment.

get_application

Get details for a specific application.

create_application

Create a new application with configuration.

update_application

Update application settings or resources.

delete_application

Delete an application.

start_application

Start a stopped application.

stop_application

Stop a running application.

restart_application

Restart an application to apply changes.

execute_command

Execute a command inside the application container.

get_application_logs

Fetch logs for an application.

list_databases

List all databases managed by the MCP server.

get_database

Get details for a specific database instance.

create_database

Create a new database with required settings.

update_database

Update database configuration.

delete_database

Delete a database instance.

start_database

Start a stopped database.

stop_database

Stop a running database.

restart_database

Restart a database instance.

list_services

List all deployed services.

get_service

Get details for a specific service.

create_service

Create a new service deployment.

update_service

Update service configuration.

delete_service

Delete a service.

start_service

Start a stopped service.

stop_service

Stop a running service.

restart_service

Restart a service.

list_environment_variables

List environment variables for applications, services, and databases.

create_environment_variable

Create a new environment variable.

update_environment_variable

Update an existing environment variable.

delete_environment_variable

Delete an environment variable.

list_deployments

List deployments across applications and environments.

get_deployment

Get details of a specific deployment.

deploy_webhook

Trigger a deployment via webhook.

list_private_keys

List private keys used for SSH access.

create_private_key

Create a new private key entry.

update_private_key

Update a private key.

delete_private_key

Delete a private key.

deploy-git-app

Deploy an application from a Git repository using pre-configured prompts.

setup-database

Set up a new database with proper configuration.

deploy-service

Deploy a pre-configured service.

environment-setup

Configure environment variables for an application deployment.

server-health-check

Run a comprehensive health check across all servers.

backup-database

Create a backup of a database.

scale-application

Scale an application by adjusting resources.

setup-ssl

Configure SSL/TLS certificates for an application.

migrate-application

Migrate an application between servers.

troubleshoot-deployment

Investigate and resolve deployment failures.