Skip to main content
Glama

Coolify MCP Server

by FelixAllistar
OverviewInspectNewSchemaRelated ServersScore
TypeScript
Remote
22
5

Coolify MCP Server

A Model Context Protocol (MCP) server for managing Coolify deployments, providing both programmatic MCP tools and comprehensive CLI commands.

Quick Start

Option 1: MCP Integration (Recommended)

MCP (Model Control Protocol) lets you manage Coolify directly from your AI editor.

1. Add to your MCP configuration

For Cursor: Add to ~/.cursor/mcp.json or <project_folder>/.cursor/mcp.json:

{ "mcpServers": { "coolify-mcp": { "command": "npx", "args": ["-y", "@felixallistar/coolify-mcp", "--server"], "env": { "COOLIFY_API_URL": "https://your-coolify-instance.com", "COOLIFY_API_TOKEN": "your-coolify-api-token" } } } }

For VS Code: Add to <project_folder>/.vscode/mcp.json:

{ "servers": { "coolify-mcp": { "command": "npx", "args": ["-y", "@felixallistar/coolify-mcp", "--server"], "env": { "COOLIFY_API_URL": "https://your-coolify-instance.com", "COOLIFY_API_TOKEN": "your-coolify-api-token" }, "type": "stdio" } } }

šŸ”‘ Replace your-coolify-instance.com with your actual Coolify URL and your-coolify-api-token with your API token from Coolify Settings > API.

2. (Cursor only) Enable Coolify MCP

Open Cursor Settings (Ctrl+Shift+J) āž” Click on MCP tab āž” Enable coolify-mcp with the toggle

3. Start managing Coolify

In your AI chat, try commands like:

List my Coolify applications Create a new WordPress service called "my-blog" Deploy my app with ID "app-123" Show me all available database types

Option 2: CLI Usage

Installation

# Install globally for CLI usage npm install -g @felixallistar/coolify-mcp # Test the installation coolify-mcp --help

Configuration

Create a .env file in your project directory:

# Required: Your Coolify instance URL (include port if needed) COOLIFY_API_URL=https://your-coolify-instance.com # Required: Your Coolify API token (generate in Coolify Settings > API) COOLIFY_API_TOKEN=your-coolify-api-token

Common Commands

# Application management coolify-mcp apps list coolify-mcp apps create-public --name "my-app" --repository "https://github.com/user/repo" --project "project-id" coolify-mcp apps start app-id # Service management (70+ one-click services) coolify-mcp services types coolify-mcp services create --name "my-blog" --type "wordpress-with-mysql" --project "project-id" # Database management (8 database types) coolify-mcp databases create-postgresql --name "main-db" --project "project-id" coolify-mcp databases create-redis --name "cache" --project "project-id" # Project management coolify-mcp projects list coolify-mcp projects create --name "My Project" # Test connectivity coolify-mcp system health

Features

šŸ”„ Applications (21 Operations)

Complete application lifecycle management with 6 deployment types, environment variables, logs, and control operations.

šŸ”§ Services (14 Operations)

70+ one-click services including WordPress, Ghost, MinIO, and more with full environment management.

šŸ—„ļø Databases (13 Operations)

8 database types: PostgreSQL, MySQL, MariaDB, MongoDB, Redis, KeyDB, ClickHouse, Dragonfly.

šŸ“‚ Projects, Servers, Deployments

Complete infrastructure management including private keys, system administration, and deployment monitoring.

MCP Tools vs CLI Commands

This package provides two interaction methods with complete feature parity:

  • šŸ¤– MCP Tools: For AI agents and Cursor integration (recommended)

  • šŸ’» CLI Commands: For direct terminal usage

Both interfaces provide identical functionality - choose based on your workflow.

Development

Automated API Updates

Stay in sync with Coolify's latest API:

npm run refresh # Download latest API spec and rebuild npm run check-updates # Check for API changes

Manual Development

git clone https://github.com/FelixAllistar/coolify-mcp.git cd coolify-mcp npm install npm run refresh npm run dev

API Coverage

āœ… 100% Coolify API Coverage - Applications, Services, Databases, Projects, Servers, Deployments, Private Keys, System Administration

License

GLWTPL (Good Luck With That Public License) - see LICENSE file for details.

This software might just work or not, there is no third option. Good luck and Godspeed.

MCP Configuration

Option 1: Using npx (Recommended - Simple!)

{ "mcpServers": { "coolify-mcp": { "command": "npx", "args": ["-y", "@felixallistar/coolify-mcp", "--server"], "env": { "COOLIFY_API_URL": "https://your-coolify-instance.com", "COOLIFY_API_TOKEN": "your-coolify-api-token" } } } }

Option 2: Direct node execution

{ "mcpServers": { "coolify-mcp": { "command": "node", "args": ["node_modules/@felixallistar/coolify-mcp/dist/index.js", "--server"], "env": { "COOLIFY_API_URL": "https://your-coolify-instance.com", "COOLIFY_API_TOKEN": "your-coolify-api-token" } } } }

Option 3: Global installation

npm install -g @felixallistar/coolify-mcp

Then use the MCP server binary:

{ "mcpServers": { "coolify-mcp": { "command": "coolify-mcp", "env": { "COOLIFY_API_URL": "https://your-coolify-instance.com", "COOLIFY_API_TOKEN": "your-coolify-api-token" } } } }

CLI Usage

For CLI commands, simply add arguments to the coolify-mcp command:

# Using npx (no installation needed) npx @felixallistar/coolify-mcp --help npx @felixallistar/coolify-mcp apps list # Or install globally for easier CLI usage npm install -g @felixallistar/coolify-mcp coolify-mcp --help coolify-mcp apps list
Deploy Server
A
security ā€“ no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

Related Resources

Tools

View all tools

Related MCP Servers

  • Coolify MCP Server

    StuMason
    A
    security
    F
    license
    A
    quality
    Enables interaction with Coolify applications and resources through the Coolify API via a standardized interface, supporting application management operations such as listing, starting, stopping, restarting, and deploying.
    Last updated -
    11
    12

  • Coolify MCP Server

    StuMason
    -
    security
    F
    license
    -
    quality
    A Model Context Protocol server that enables AI assistants to interact with Coolify instances through natural language, allowing management of servers, applications, databases, and deployments.
    Last updated -
    112
    70

  • Coolify MCP Server

    wrediam
    A
    security
    F
    license
    A
    quality
    A Model Context Protocol server that provides integration with the Coolify API, enabling DevOps teams to manage Coolify deployments, applications, services, and servers through MCP tools.
    Last updated -
    32
    55
    29
    • Linux
    • Apple

  • Coolify MCP Server

    pavelsukhachev
    -
    security
    A
    license
    -
    quality
    An MCP server that enables AI assistants to manage infrastructure, applications, databases, and services through the Coolify PaaS platform.
    Last updated -
    2
    3
    MIT License

View all related MCP servers

New MCP Servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/FelixAllistar/coolify-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server