Coolify MCP Server
Allows creating and managing ClickHouse databases within Coolify.
Enables creating and managing applications from Dockerfiles, Docker images, and Docker Compose via Coolify.
Integrates with GitHub for authentication and deploying private repositories as applications.
Allows creating and managing MariaDB databases within Coolify.
Allows creating and managing MongoDB databases within Coolify.
Allows creating and managing MySQL databases within Coolify.
Allows creating and managing PostgreSQL databases within Coolify.
Allows creating and managing Redis databases within Coolify.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Coolify MCP ServerCreate a new PostgreSQL database for project 'myapp'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Coolify MCP Server
A Model Context Protocol (MCP) server for the Coolify API. Manage your self-hosted PaaS infrastructure through AI assistants like Claude.
Quick Install
curl -fsSL https://raw.githubusercontent.com/Ruashots/coolify-mcp/master/install.sh | bashThis will:
Clone the repository to
~/.local/share/coolify-mcpInstall dependencies and build
Prompt for your Coolify URL and API token
Configure Claude Code automatically
Other commands:
# Reconfigure credentials
~/.local/share/coolify-mcp/install.sh --reconfigure
# Uninstall
~/.local/share/coolify-mcp/install.sh --uninstallRelated MCP server: Enhanced Coolify MCP Server
Features
70+ tools covering the complete Coolify API:
Applications - Deploy from Git repos, Dockerfiles, Docker images, or Docker Compose
Databases - PostgreSQL, MySQL, MariaDB, MongoDB, Redis, ClickHouse, DragonFly, KeyDB
Services - Template-based services or custom Docker Compose stacks
Servers - Manage and validate your infrastructure
Projects & Environments - Organize your resources
Deployments - Deploy by UUID, tag, or PR preview
Environment Variables - Full CRUD with bulk operations
Prerequisites
Node.js 18+
A running Coolify instance
Coolify API token
jq(for automatic Claude Code configuration)
Manual Installation
# Clone the repository
git clone https://github.com/Ruashots/coolify-mcp.git
cd coolify-mcp
# Install dependencies
npm install
# Build
npm run buildGetting a Coolify API Token
Log into your Coolify dashboard
Go to Keys & Tokens > API tokens
Click Create New Token
Copy the token (only shown once)
Usage
Claude Code CLI
Add the MCP server using the claude CLI:
claude mcp add coolify \
--transport stdio \
-e COOLIFY_API_TOKEN="your-api-token" \
-e COOLIFY_BASE_URL="http://your-coolify-instance:8000" \
-- node /path/to/coolify-mcp/dist/index.jsScope options:
Flag | Description |
(default) | Local to current directory |
| Available across all your projects |
| Shared with team via |
Manage the server:
# List configured servers
claude mcp list
# Check server details
claude mcp get coolify
# Remove server
claude mcp remove coolifyClaude Desktop
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"coolify": {
"command": "node",
"args": ["/path/to/coolify-mcp/dist/index.js"],
"env": {
"COOLIFY_API_TOKEN": "your-api-token",
"COOLIFY_BASE_URL": "http://your-coolify-instance:8000"
}
}
}
}Manual / Environment Variables
export COOLIFY_API_TOKEN="your-api-token"
export COOLIFY_BASE_URL="http://your-coolify-instance:8000"
node /path/to/coolify-mcp/dist/index.jsAvailable Tools
System
Tool | Description |
| Check instance health |
| Get Coolify version |
| Enable the API |
Teams
Tool | Description |
| List all teams |
| Get current team |
| Get team members |
Projects
Tool | Description |
| List all projects |
| Get project by UUID |
| Create new project |
| Update project |
| Delete project |
Environments
Tool | Description |
| Get environment |
| Create environment |
| Delete environment |
Servers
Tool | Description |
| List all servers |
| Get server by UUID |
| Add new server |
| Update server |
| Delete server |
| Validate connectivity |
| Get deployed resources |
| Get domain mappings |
GitHub Apps
Tool | Description |
| List all GitHub Apps (get UUID and ID for private repos) |
| List repositories accessible by a GitHub App (use numeric |
Private Keys
Tool | Description |
| List SSH keys |
| Get key by UUID |
| Create SSH key |
| Update key |
| Delete key |
Applications
Tool | Description |
| List all applications |
| Get application by UUID |
| Create from public Git repo |
| Create from GitHub (App auth) |
| Create from private repo (SSH) |
| Create from Dockerfile |
| Create from Docker image |
| Create from Docker Compose |
| Update application |
| Delete application |
| Start/deploy application |
| Stop application |
| Restart application |
| Get logs |
Application Environment Variables
Tool | Description |
| List env vars |
| Create env var |
| Update env var |
| Delete env var |
| Bulk update |
Databases
Tool | Description |
| List all databases |
| Get database by UUID |
| Create PostgreSQL |
| Create MySQL |
| Create MariaDB |
| Create MongoDB |
| Create Redis |
| Create ClickHouse |
| Create DragonFly |
| Create KeyDB |
| Update database |
| Delete database |
| Start database |
| Stop database |
| Restart database |
Services
Tool | Description |
| List all services |
| Get service by UUID |
| Create service |
| Update service |
| Delete service |
| Start service |
| Stop service |
| Restart service |
Service Environment Variables
Tool | Description |
| List env vars |
| Create env var |
| Update env var |
| Delete env var |
Deployments
Tool | Description |
| Deploy by UUID or tag |
| List deployments |
| Get deployment details |
Resources
Tool | Description |
| List all resources |
Example Prompts
Once configured, use natural language:
"List all my applications"
"Create a PostgreSQL database called 'myapp-db' in the production environment"
"Deploy application abc-123 with a force rebuild"
"Show me the last 100 lines of logs for my-api"
"Add DATABASE_URL environment variable to my-app"
"Stop all services in the staging project"
"What servers do I have and what's running on them?"Development
npm install # Install dependencies
npm run dev # Run in development mode
npm run build # Build for production
npm run watch # Watch modeSecurity
Keep API tokens secure and never commit them to version control
Use environment variables for sensitive configuration
Create tokens with minimal required permissions
The
can_read_sensitivepermission controls access to passwords and API keys
License
MIT
Links
Coolify - Self-hosting with superpowers
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/Ruashots/coolify-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server