Skip to main content
Glama
FelixAllistar

Coolify MCP Server

by FelixAllistar
OverviewInspectSchemaRelated ServersScoreDiscussions
TypeScript
Remote

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

Related MCP server: Coolify MCP Server

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
One-click Deploy
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

New MCP Servers

Latest Blog Posts

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