Skip to main content
Glama
Coolify MCP Server
by kof70

Coolify MCP Server

npm version CI License: MIT Node.js Version Visits

A Model Context Protocol (MCP) server for Coolify API integration. Control your self-hosted PaaS directly from Claude, Kiro, or any MCP-compatible AI assistant.

Compatible with Coolify v4.0.0-beta.454+ Official npm package for this repository: coolify-mcp-server-kof70

🚀 Features

  • Complete API Coverage: Applications, Databases, Servers, Projects, Services, Teams, Deployments, Private Keys

  • MCP Resources: Direct resource access via coolify:// URIs

  • Version Detection: Automatic feature compatibility based on Coolify version

  • Rate Limiting: Built-in rate limit handling with retry logic

  • Minimal Dependencies: Only axios and MCP SDK

  • TypeScript: Full type safety

Related MCP server: Coolify MCP Server

📦 Installation

Run the interactive setup wizard:

npx coolify-mcp-server-kof70 --setup

This will:

  1. Ask for your Coolify URL and API token

  2. Validate the connection

  3. Configure your IDE automatically (Kiro, Cursor, VS Code, Claude Desktop)

Quick Setup with Arguments

npx coolify-mcp-server-kof70 --setup --url https://coolify.example.com --token your-token --ide kiro

Global Installation

npm install -g coolify-mcp-server-kof70
coolify-mcp --setup

From Source

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

⚙️ Configuration

Environment Variables

Variable

Required

Description

COOLIFY_BASE_URL

Yes

Your Coolify instance URL (e.g., https://coolify.example.com)

COOLIFY_TOKEN

Yes

API token from Coolify

COOLIFY_TEAM_ID

No

Team ID for multi-team setups

COOLIFY_READONLY

No

Set to true for read-only mode (safe monitoring)

COOLIFY_REQUIRE_CONFIRM

No

Set to true to require confirmation for dangerous operations

COOLIFY_ACCOUNTS_FILE

No

Path to a multi-account config file (default: ~/.config/coolify-mcp/accounts.json)

COOLIFY_ACTIVE_ACCOUNT

No

Which account to activate on startup, if the accounts file doesn't set a default

🔀 Multiple accounts / teams / instances

If you manage several Coolify accounts (different teams, or even different self-hosted instances), you don't need one MCP server config per account. Create ~/.config/coolify-mcp/accounts.json:

{
  "default": "work",
  "accounts": [
    { "name": "work", "baseUrl": "https://coolify.example.com", "token": "1|xxxx" },
    { "name": "client-x", "baseUrl": "https://coolify.client-x.com", "token": "2|yyyy", "teamId": "3" }
  ]
}

Then use these tools from your assistant, no server restart required:

  • list_accounts — shows configured accounts (name, base URL, masked token) and which one is active.

  • switch_account { name } — switches every subsequent tool call to that account for the rest of the session.

  • add_account { name, base_url, token, team_id?, set_default? } — saves a new account to the file (does not switch to it automatically).

If no accounts file exists, the server falls back to the legacy single-account COOLIFY_BASE_URL/COOLIFY_TOKEN environment variables, exposed as an account named env — existing single-account setups keep working unchanged.

🔒 Read-Only Mode

For safe monitoring without risk of accidental changes, enable read-only mode:

{
  "mcpServers": {
    "coolify": {
      "command": "coolify-mcp",
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify.com",
        "COOLIFY_TOKEN": "your-api-token",
        "COOLIFY_READONLY": "true"
      }
    }
  }
}

In read-only mode, only these operations are available:

  • get_* - Get details of resources

  • list_* - List resources

  • health_check - Check API health

All write operations (create_*, start_*, stop_*, restart_*, deploy_*, execute_command) are disabled.

⚠️ Confirmation for Dangerous Operations

For extra safety, you can require confirmation before executing dangerous operations:

{
  "mcpServers": {
    "coolify": {
      "command": "coolify-mcp",
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify.com",
        "COOLIFY_TOKEN": "your-api-token",
        "COOLIFY_REQUIRE_CONFIRM": "true"
      }
    }
  }
}

When enabled, these operations require explicit confirmation:

  • stop_application, restart_application

  • stop_service, restart_service

  • deploy_application

  • execute_command

Without confirm: true, these operations return a warning:

{
  "confirmation_required": true,
  "action": "stop_application",
  "warning": "This will stop the application and make it unavailable until restarted.",
  "message": "This is a dangerous operation. To proceed, call again with confirm: true",
  "example": { "uuid": "abc123", "confirm": true }
}

To execute, call again with confirm: true:

stop_application({ uuid: "abc123", confirm: true })

Getting an API Token

  1. Go to your Coolify instance

  2. Navigate to Keys & Tokens → API tokens

  3. Create a new token with required permissions:

    • read - For listing resources

    • write - For creating/updating resources

    • deploy - For deployment operations

🔧 Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "coolify": {
      "command": "coolify-mcp",
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify.com",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

With Kiro

Add to your .kiro/settings/mcp.json:

{
  "mcpServers": {
    "coolify": {
      "command": "coolify-mcp",
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify.com",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

From Source

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

🛠️ Available Tools

Accounts

Tool

Description

list_accounts

List configured accounts and show the active one

switch_account

Switch the active account for the rest of the session

add_account

Save a new named account to the accounts file

Version & Health

Tool

Description

get_version

Get Coolify version information

health_check

Check API health status

Teams

Tool

Description

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

get_team_members

Get members of a specific team

Servers

Tool

Description

list_servers

List all servers

get_server

Get server details by UUID

create_server

Create a new server

update_server

Update a server

delete_server

Delete a server

validate_server

Validate server connection

get_server_resources

Get server resource usage

get_server_domains

Get domains configured on a server

Projects & Environments

Tool

Description

list_projects

List all projects

get_project

Get project details

create_project

Create a new project

update_project

Update a project

delete_project

Delete a project

list_environments

List environments in a project

get_environment

Get environment details

create_environment

Create a new environment

delete_environment

Delete an environment

Applications

Tool

Description

list_applications

List all applications

get_application

Get application details

create_public_application

Create from a public Git repository

create_private_github_app_application

Create from private repo using GitHub App

create_private_deploy_key_application

Create from private repo using deploy key

create_dockerfile_application

Create from a Dockerfile

create_dockerimage_application

Create from a Docker image

create_dockercompose_application

Create from Docker Compose

update_application

Update an application

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

deploy

Deploy resources by UUID or tag

execute_command

Execute command in container

get_application_logs

Get application logs

get_application_deployments

Get all deployments for an application

Application Storages

Tool

Description

get_application_storages

List persistent/file storages mounted on an application

create_application_storage

Mount a persistent volume or a single file

update_application_storage

Update an existing mounted storage

delete_application_storage

Remove a mounted storage

Application Environment Variables

Tool

Description

get_application_envs

Get environment variables for an application

create_application_env

Create an environment variable

update_application_env

Update an environment variable

delete_application_env

Delete an environment variable

update_application_envs_bulk

Update multiple environment variables in bulk

Services

Tool

Description

list_services

List all services

get_service

Get service details by UUID

create_service

Create a new service

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

Service Environment Variables

Tool

Description

get_service_envs

Get environment variables for a service

create_service_env

Create an environment variable

update_service_env

Update an environment variable

delete_service_env

Delete an environment variable

update_service_envs_bulk

Update multiple environment variables in bulk

Databases

Tool

Description

list_databases

List all databases

get_database

Get database details by UUID

create_database

Create a new database (PostgreSQL, MySQL, MariaDB, MongoDB, Redis, ClickHouse, Dragonfly, KeyDB)

update_database

Update a database

delete_database

Delete a database

start_database

Start a database

stop_database

Stop a database

restart_database

Restart a database

get_database_backups

Get backup configurations for a database

create_database_backup

Create a backup configuration

Deployments

Tool

Description

list_deployments

List all deployments

get_deployment

Get deployment details

cancel_deployment

Cancel a deployment in progress

Private Keys

Tool

Description

list_private_keys

List all SSH private keys

get_private_key

Get a private key by UUID

create_private_key

Create a new SSH private key

update_private_key

Update a private key

delete_private_key

Delete a private key

GitHub Apps

Tool

Description

list_github_apps

List all GitHub Apps configured in Coolify

get_github_app

Get GitHub App details by ID

create_github_app

Create a new GitHub App configuration

update_github_app

Update a GitHub App configuration

delete_github_app

Delete a GitHub App configuration

get_github_app_repositories

Get repositories accessible by a GitHub App

get_github_app_repository_branches

Get branches of a repository

Resources

Tool

Description

list_resources

List all resources (applications, services, databases)

📚 MCP Resources

Access data directly via MCP resources:

coolify://applications    - List all applications
coolify://databases       - List all databases
coolify://servers         - List all servers
coolify://projects        - List all projects
coolify://services        - List all services
coolify://teams           - List all teams
coolify://deployments     - List all deployments
coolify://private-keys    - List all private keys

💡 Example Prompts

Once configured, you can ask your AI assistant:

  • "List all my Coolify applications"

  • "Deploy the app with UUID abc123"

  • "Show me the logs for my-app"

  • "Create a new PostgreSQL database called mydb"

  • "What servers do I have in Coolify?"

  • "Restart the production application"

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'feat: add amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

📮 Support

Available Tools

89 tools
cancel_deploymentA

Cancel a deployment. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), confirm.

create_applicationD

Create a new application

Inputs: project_uuid (required), environment_name (required), destination_uuid (required), environment_uuid, +2 more.

create_application_envB

Create an environment variable for an application

Inputs: uuid (required), key (required), value, is_preview, +2 more.

create_databaseB

Create a new database. Valid types: postgresql, mysql, mariadb, mongodb, redis, clickhouse, dragonfly, keydb

Inputs: type (required), server_uuid (required), project_uuid (required), environment_name (required), +6 more.

create_database_backupC

Create a backup configuration for a database

Inputs: uuid (required), enabled, frequency, retention.

create_dockercompose_applicationB

Create a new application from Docker Compose configuration

Inputs: project_uuid (required), environment_name (required), server_uuid (required), docker_compose_raw (required), +5 more.

create_dockerfile_applicationB

Create a new application from a Dockerfile

Inputs: project_uuid (required), environment_name (required), server_uuid (required), dockerfile (required), +6 more.

create_dockerimage_applicationB

Create a new application from a Docker image

Inputs: project_uuid (required), environment_name (required), server_uuid (required), docker_registry_image_name (required), +7 more.

create_environmentB

Create a new environment in a project

Inputs: project_uuid (required), name (required).

create_github_appC

Create a new GitHub App configuration

Inputs: name (required), organization, api_url, html_url, +3 more.

create_private_deploy_key_applicationB

Create a new application from a private Git repository using deploy key authentication

Inputs: project_uuid (required), environment_name (required), server_uuid (required), git_repository (required), +9 more.

create_private_github_app_applicationB

Create a new application from a private Git repository using GitHub App authentication

Inputs: project_uuid (required), environment_name (required), server_uuid (required), git_repository (required), +9 more.

create_private_keyC

Create a new SSH private key

Inputs: name (required), private_key (required), description.

create_projectB

Create a new project

Inputs: name (required), description.

create_public_applicationB

Create a new public application from a public Git repository

Inputs: project_uuid (required), environment_name (required), server_uuid (required), git_repository (required), +8 more.

create_serverC

Create a new server

Inputs: name (required), ip (required), private_key_uuid (required), description, +4 more.

create_serviceC

Create a new service

Inputs: type (required), name (required), project_uuid (required), environment_name (required), +1 more.

create_service_envB

Create an environment variable for a service

Inputs: uuid (required), key (required), value, is_preview, +2 more.

delete_applicationB

Delete an application. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), confirm.

delete_application_envB

Delete an environment variable from an application

Inputs: uuid (required), env_uuid (required).

delete_databaseB

Delete a database. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), confirm.

delete_environmentA

Delete an environment. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: project_uuid (required), environment_name_or_uuid (required), confirm.

delete_github_appA

Delete a GitHub App configuration. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: github_app_id (required), confirm.

delete_private_keyA

Delete a private key. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), confirm.

delete_projectB

Delete a project. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), confirm.

delete_serverB

Delete a server. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), confirm.

delete_serviceA

Delete a service. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), confirm.

delete_service_envB

Delete an environment variable from a service

Inputs: uuid (required), env_uuid (required).

deployC

Deploy resources by UUID or tag. Supports deploying multiple resources at once using comma-separated values.

Inputs: uuid, tag, force, confirm.

deploy_applicationB

Deploy an application. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), tag, force, instant_deploy, +1 more.

execute_commandB

Execute a command in an application container. NOTE: This endpoint is not available in Coolify API and will return an error.

Inputs: uuid (required), command (required), confirm.

get_applicationC

Get application details

Inputs: uuid (required).

get_application_deploymentsB

Get all deployments for an application

Inputs: uuid (required).

get_application_envsB

Get environment variables for an application

Inputs: uuid (required).

get_application_logsC

Get application logs

Inputs: uuid (required), lines.

get_current_teamA

Get details of the current team

Inputs: no named parameters.

get_current_team_membersB

Get members of the current team

Inputs: no named parameters.

get_databaseA

Get database details by UUID

Inputs: uuid (required).

get_database_backupsC

Get backup configurations for a database

Inputs: uuid (required).

get_database_logsC

Get logs from a database. NOTE: This endpoint is not available in Coolify API and will return an error. Database logs are not exposed via the API.

Inputs: uuid (required), lines.

get_deploymentC

Get deployment details

Inputs: uuid (required).

get_environmentC

Get environment details

Inputs: project_uuid (required), environment_name_or_uuid (required).

get_github_appA

Get GitHub App details by ID

Inputs: github_app_id (required).

get_github_app_repositoriesB

Get repositories accessible by a GitHub App

Inputs: github_app_id (required).

get_github_app_repository_branchesB

Get branches of a repository accessible by a GitHub App

Inputs: github_app_id (required), owner (required), repo (required).

get_private_keyB

Get a private key by UUID

Inputs: uuid (required).

get_projectC

Get project details

Inputs: uuid (required).

get_serverA

Get server details by UUID

Inputs: uuid (required).

get_server_domainsB

Get domains configured on a server

Inputs: uuid (required).

get_server_resourcesB

Get server resource usage

Inputs: uuid (required).

get_serviceC

Get service details by UUID

Inputs: uuid (required).

get_service_envsA

Get environment variables for a service

Inputs: uuid (required).

get_service_logsA

Get logs from a service. NOTE: This endpoint is not available in Coolify API and will return an error. Service logs are not exposed via the API.

Inputs: uuid (required), lines.

get_teamB

Get details of a specific team

Inputs: team_id (required).

get_team_membersC

Get members of a specific team

Inputs: team_id (required).

get_versionA

Get Coolify version information

Inputs: no named parameters.

health_checkA

Check Coolify API health status

Inputs: no named parameters.

list_applicationsC

List all applications

Inputs: no named parameters.

list_databasesA

List all databases

Inputs: no named parameters.

list_deploymentsB

List all deployments

Inputs: no named parameters.

list_environmentsB

List environments in a project

Inputs: project_uuid (required).

list_github_appsA

List all GitHub Apps configured in Coolify

Inputs: no named parameters.

list_private_keysA

List all SSH private keys

Inputs: no named parameters.

list_projectsB

List all projects

Inputs: no named parameters.

list_resourcesB

List all resources (applications, services, databases)

Inputs: no named parameters.

list_serversA

List all servers in Coolify

Inputs: no named parameters.

list_servicesA

List all services

Inputs: no named parameters.

list_teamsA

List all teams accessible to the authenticated user

Inputs: no named parameters.

restart_applicationA

Restart an application. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), confirm.

restart_databaseA

Restart a database. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), confirm.

restart_serviceA

Restart a service. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), confirm.

start_applicationC

Start an application

Inputs: uuid (required).

start_databaseC

Start a database

Inputs: uuid (required).

start_serviceD

Start a service

Inputs: uuid (required).

stop_applicationA

Stop an application. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), confirm.

stop_databaseA

Stop a database. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), confirm.

stop_serviceA

Stop a service. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Inputs: uuid (required), confirm.

update_applicationC

Update an application

Inputs: uuid (required), name, description.

update_application_envC

Update an environment variable for an application

Inputs: uuid (required), key (required), value, is_preview, +2 more.

update_application_envs_bulkB

Update multiple environment variables for an application in bulk

Inputs: uuid (required), data (required).

update_databaseD

Update a database

Inputs: uuid (required), name, description.

update_github_appB

Update a GitHub App configuration

Inputs: github_app_id (required), name, organization, api_url, +4 more.

update_private_keyC

Update a private key

Inputs: uuid (required), name, description, private_key.

update_projectC

Update a project

Inputs: uuid (required), name, description.

update_serverC

Update a server

Inputs: uuid (required), name, description, ip, +2 more.

update_serviceC

Update a service

Inputs: uuid (required), name, description, docker_compose_raw.

update_service_envC

Update an environment variable for a service

Inputs: uuid (required), key (required), value, is_preview, +2 more.

update_service_envs_bulkB

Update multiple environment variables for a service in bulk

Inputs: uuid (required), data (required).

validate_serverC

Validate server connection

Inputs: uuid (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 89 tools

    Disambiguation4/5

    Most tools have clear distinct purposes, but there is some overlap between deploy and deploy_application, and multiple create_application methods could cause ambiguity. Overall, the descriptions help differentiate.

    Naming Consistency5/5

    All tools use consistent verb_noun snake_case naming (e.g., create_application, delete_server, list_projects). The pattern is uniform and predictable, with only minor exceptions like health_check.

    Tool Count2/5

    89 tools is excessively large for a single MCP server. While the domain is broad, many tools could be consolidated or parameterized. The count far exceeds typical coherence standards.

    Completeness4/5

    The tool set provides full CRUD and lifecycle operations for most resources (applications, databases, services, servers, etc.). However, some endpoints are unavailable (execute_command, database/service logs) and domain management is incomplete.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to interact with Coolify self-hosted instances for application deployment, management, and monitoring. Features 4 unified tools optimized for VS Code's limits, covering app management, environment configuration, system administration, and built-in documentation.
      4
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to interact with Coolify for complete infrastructure management including applications, databases, servers, deployments, and team operations. Provides 100% API coverage with 64 tools for managing the entire Coolify ecosystem through natural language.
      18
      8 npm
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage Coolify infrastructure including servers, applications, databases, deployments, and 80+ one-click services through 98 comprehensive tools for both cloud and self-hosted instances.
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables management of Coolify instances to control applications, databases, and servers through the Model Context Protocol. It provides a comprehensive set of tools for deploying services and monitoring self-hosted infrastructure using natural language.
      18
      12 npm
      3
      MIT