coolify-mcp
Allows management of Docker-based applications and services on a Coolify instance, including creation from Dockerfiles or images, starting, stopping, and restarting.
Provides tools for managing MariaDB databases on a Coolify instance, including creation, backup, and lifecycle operations.
Provides tools for managing MongoDB databases on a Coolify instance, including creation, backup, and lifecycle operations.
Provides tools for managing MySQL databases on a Coolify instance, including creation, backup, and lifecycle operations.
Provides tools for managing PostgreSQL databases on a Coolify instance, including creation, backup, and lifecycle operations.
Provides tools for managing Redis databases on a Coolify instance, including creation, backup, and lifecycle operations.
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-mcplist all applications"
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
MCP server for managing Coolify instances. Control applications, databases, services, servers, and more directly from Claude or any MCP-compatible client.
74 tools | 7 resources | 4 prompts
Installation
Claude Code
claude mcp add coolify \
-e COOLIFY_API_URL=http://your-server:8000/api/v1 \
-e COOLIFY_TOKEN=your-token \
-- npx coolify-mcpCodex
codex mcp add coolify \
--env COOLIFY_API_URL=http://your-server:8000/api/v1 \
--env COOLIFY_TOKEN=your-token \
-- npx coolify-mcpOther MCP clients
COOLIFY_API_URL=http://your-server:8000/api/v1 \
COOLIFY_TOKEN=your-token \
npx coolify-mcpFrom source
git clone https://github.com/0xtlt/coolify-mcp
cd coolify-mcp && bun install
COOLIFY_API_URL=... COOLIFY_TOKEN=... bun run src/index.tsClaude Desktop
Add to ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"coolify": {
"command": "bun",
"args": ["run", "/path/to/coolify-mcp/src/index.ts"],
"env": {
"COOLIFY_API_URL": "http://your-server:8000/api/v1",
"COOLIFY_TOKEN": "your-token"
}
}
}
}Get your API token
Coolify dashboard: Keys & Tokens > API tokens
Related MCP server: Coolify MCP Server
Available Tools
Applications (8)
Tool | Description |
| List all applications (summary) |
| Get application details |
| [WRITE] Create from public/private repo, Dockerfile, or Docker image |
| [WRITE] Update application config |
| [WRITE] Start a stopped application |
| [DESTRUCTIVE] Stop an application |
| [DESTRUCTIVE] Restart an application |
| [DESTRUCTIVE] Delete an application |
Databases (11)
Tool | Description |
| List all databases (summary) |
| Get database details |
| [WRITE] Create PostgreSQL, MySQL, MariaDB, MongoDB, Redis, etc. |
| [WRITE] Update database config |
| List backups for a database |
| [WRITE] Create a database backup |
| [DESTRUCTIVE] Delete a scheduled backup config |
| [WRITE] Start a stopped database |
| [DESTRUCTIVE] Stop a database |
| [DESTRUCTIVE] Restart a database |
| [DESTRUCTIVE] Delete a database |
Services (8)
Tool | Description |
| List all services (summary) |
| Get service details |
| [WRITE] Create a one-click Docker Compose service |
| [WRITE] Update service config |
| [WRITE] Start a stopped service |
| [DESTRUCTIVE] Stop a service |
| [DESTRUCTIVE] Restart a service |
| [DESTRUCTIVE] Delete a service |
Servers (8)
Tool | Description |
| List all servers (summary) |
| Get server details |
| [WRITE] Add a new server (requires SSH key) |
| [WRITE] Update server config |
| Check SSH connectivity and Docker |
| List all resources on a server |
| List all domains on a server |
| [DESTRUCTIVE] Delete a server |
Private Keys (5)
Tool | Description |
| List all SSH private keys (summary) |
| Get private key details |
| [WRITE] Create a new SSH key |
| [WRITE] Update an SSH key |
| [DESTRUCTIVE] Delete an SSH key |
Projects & Environments (9)
Tool | Description |
| List all projects (summary) |
| Get project details |
| [WRITE] Create a new project |
| [WRITE] Update a project |
| [DESTRUCTIVE] Delete a project |
| List environments in a project |
| Get environment details |
| [WRITE] Create an environment |
| [DESTRUCTIVE] Delete an environment |
Deployments (5)
Tool | Description |
| List currently running/queued deployments |
| List deployment history for an application (with pagination) |
| Get deployment details |
| [WRITE] Trigger a deployment |
| [WRITE] Cancel a running deployment |
Application Env Vars (4)
Tool | Description |
| List env vars for an application |
| [WRITE] Create an env var |
| [WRITE] Bulk update env vars |
| [DESTRUCTIVE] Delete an env var |
Service Env Vars (4)
Tool | Description |
| List env vars for a service |
| [WRITE] Create a service env var |
| [WRITE] Bulk update service env vars |
| [DESTRUCTIVE] Delete a service env var |
Database Env Vars (4)
Tool | Description |
| List env vars for a database |
| [WRITE] Create a database env var |
| [WRITE] Bulk update database env vars |
| [DESTRUCTIVE] Delete a database env var |
Logs (3)
Tool | Description |
| Get application logs with filtering |
| Get database logs with filtering |
| Get service logs with filtering |
System (2)
Tool | Description |
| Get Coolify instance version |
| Check if Coolify is healthy |
Teams (3)
Tool | Description |
| List all teams |
| Get current authenticated team |
| List members of a team |
Available Resources
URI | Description |
| List of all applications |
| List of all databases |
| List of all services |
| List of all servers |
| List of all deployments |
| List of all projects |
| List of all SSH private keys |
Available Prompts
Prompt | Description |
| Step-by-step guide to debug a failed deployment |
| Get a complete overview of all infrastructure |
| Guided workflow to deploy an application |
| Guided workflow to create and configure a new app |
Safety Modes
Variable | Description |
| Only read operations available (list, get, logs) |
| Destructive operations require |
Log Filtering
The coolify_get_logs, coolify_get_database_logs, and coolify_get_service_logs tools support:
level: Minimum log level (debug, info, warn, error, fatal)since/until: ISO 8601 timestamps for time rangesearch: Case-insensitive text searchlimit: Max entries (default 100)tail: Get most recent logs
Environment Variables
Variable | Required | Description |
| Yes | Coolify API URL (e.g. |
| Yes | Bearer token from Coolify dashboard |
| No | Request timeout in ms (default: 30000) |
| No | Read-only mode (default: false) |
| No | Require confirmation for destructive ops (default: false) |
| No | Enable debug logging (default: false) |
Development
bun install # Install dependencies
bun run dev # Watch mode
bun run inspect # MCP Inspector
bun run check # Lint + typecheck + test
bun test # Run tests onlyLicense
MIT
This server cannot be installed
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
- 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/0xtlt/coolify-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server