Coolify MCP Server
This server is an MCP integration that lets AI assistants manage a Coolify self-hosted PaaS (applications, databases, servers, projects, services, deployments, and more) through natural-language tool calls.
Account & instance management: list, switch, and add multiple Coolify accounts; check version and API health
Teams: list teams, view current team and members
Servers: list, create, update, delete, validate, inspect resource usage and domains
Projects & environments: list, create, update, delete projects; manage environments
Applications: create from public/private repos, Dockerfile, Docker image, or Docker Compose; get/update/delete; start, stop, restart, deploy; fetch logs and deployments
Application environment variables: read, create, update, delete, and bulk-update env vars
Services: create, update, delete, start, stop, restart services; manage service env vars; fetch logs (where available)
Databases: create supported database types (PostgreSQL, MySQL, MariaDB, MongoDB, Redis, ClickHouse, Dragonfly, KeyDB), update/delete, start/stop/restart, manage backups
Deployments: list deployments, get details, cancel deployments, deploy by UUID or tag
Private keys: list, create, update, delete SSH private keys
GitHub Apps: list, create, update, delete GitHub App configs; inspect repositories and branches
Resource overview: list all applications, services, databases, servers, projects, teams, deployments, and private keys
Safety modes: optional read-only mode and confirmation prompts for dangerous operations
Enables management and deployment of MongoDB databases through Coolify's self-hosted PaaS platform, including database creation and monitoring.
Enables management and deployment of MySQL databases through Coolify's self-hosted PaaS platform, including database creation and monitoring.
Enables management and deployment of PostgreSQL databases through Coolify's self-hosted PaaS platform, including database creation and monitoring.
Enables management and deployment of Redis databases through Coolify's self-hosted PaaS platform, including database creation and monitoring.
Click on "Deploy 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 Server deploy the latest version of my web app to production"
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 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://URIsVersion 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
Quick Setup (Recommended)
Run the interactive setup wizard:
npx coolify-mcp-server-kof70 --setupThis will:
Ask for your Coolify URL and API token
Validate the connection
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 kiroGlobal Installation
npm install -g coolify-mcp-server-kof70
coolify-mcp --setupFrom 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 |
| Yes | Your Coolify instance URL (e.g., |
| Yes | API token from Coolify |
| No | Team ID for multi-team setups |
| No | Set to |
| No | Set to |
| No | Path to a multi-account config file (default: |
| No | Which account to activate on startup, if the accounts file doesn't set a |
🔀 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 resourceslist_*- List resourceshealth_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_applicationstop_service,restart_servicedeploy_applicationexecute_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
Go to your Coolify instance
Navigate to Keys & Tokens → API tokens
Create a new token with required permissions:
read- For listing resourceswrite- For creating/updating resourcesdeploy- 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 configured accounts and show the active one |
| Switch the active account for the rest of the session |
| Save a new named account to the accounts file |
Version & Health
Tool | Description |
| Get Coolify version information |
| Check API health status |
Teams
Tool | Description |
| List all accessible teams |
| Get team details by ID |
| Get current team details |
| Get current team members |
| Get members of a specific team |
Servers
Tool | Description |
| List all servers |
| Get server details by UUID |
| Create a new server |
| Update a server |
| Delete a server |
| Validate server connection |
| Get server resource usage |
| Get domains configured on a server |
Projects & Environments
Tool | Description |
| List all projects |
| Get project details |
| Create a new project |
| Update a project |
| Delete a project |
| List environments in a project |
| Get environment details |
| Create a new environment |
| Delete an environment |
Applications
Tool | Description |
| List all applications |
| Get application details |
| Create from a public Git repository |
| Create from private repo using GitHub App |
| Create from private repo using deploy key |
| Create from a Dockerfile |
| Create from a Docker image |
| Create from Docker Compose |
| Update an application |
| Delete an application |
| Start an application |
| Stop an application |
| Restart an application |
| Deploy an application |
| Deploy resources by UUID or tag |
| Execute command in container |
| Get application logs |
| Get all deployments for an application |
Application Storages
Tool | Description |
| List persistent/file storages mounted on an application |
| Mount a persistent volume or a single file |
| Update an existing mounted storage |
| Remove a mounted storage |
Application Environment Variables
Tool | Description |
| Get environment variables for an application |
| Create an environment variable |
| Update an environment variable |
| Delete an environment variable |
| Update multiple environment variables in bulk |
Services
Tool | Description |
| List all services |
| Get service details by UUID |
| Create a new service |
| Update a service |
| Delete a service |
| Start a service |
| Stop a service |
| Restart a service |
Service Environment Variables
Tool | Description |
| Get environment variables for a service |
| Create an environment variable |
| Update an environment variable |
| Delete an environment variable |
| Update multiple environment variables in bulk |
Databases
Tool | Description |
| List all databases |
| Get database details by UUID |
| Create a new database (PostgreSQL, MySQL, MariaDB, MongoDB, Redis, ClickHouse, Dragonfly, KeyDB) |
| Update a database |
| Delete a database |
| Start a database |
| Stop a database |
| Restart a database |
| Get backup configurations for a database |
| Create a backup configuration |
Deployments
Tool | Description |
| List all deployments |
| Get deployment details |
| Cancel a deployment in progress |
Private Keys
Tool | Description |
| List all SSH private keys |
| Get a private key by UUID |
| Create a new SSH private key |
| Update a private key |
| Delete a private key |
GitHub Apps
Tool | Description |
| List all GitHub Apps configured in Coolify |
| Get GitHub App details by ID |
| Create a new GitHub App configuration |
| Update a GitHub App configuration |
| Delete a GitHub App configuration |
| Get repositories accessible by a GitHub App |
| Get branches of a repository |
Resources
Tool | Description |
| 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.
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'feat: add amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
📝 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
Coolify - The amazing self-hosted PaaS
Model Context Protocol - The MCP specification
All contributors who help improve this project
📮 Support
Available Tools
89 toolscancel_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
Scored across 89 tools
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.
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.
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.
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
Related MCP Connectors
Deploy apps from GitHub, read build/runtime logs, and manage your app's users from your AI agent.
Deploy and manage your apps, databases, storage, and scheduled jobs from your AI agent
Inspect and control your Northflank projects, services, jobs, and builds from your AI assistant.
Manage HepCloud (Turkish cloud) servers and managed PostgreSQL from your AI assistant. OAuth 2.1.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables 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.41MIT
- AlicenseBqualityDmaintenanceEnables 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.188 npm6MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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
- AlicenseBqualityDmaintenanceEnables 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.1812 npm3MIT