Coolify MCP Tools
A comprehensive Model Context Protocol (MCP) server for Coolify - the open-source, self-hostable Heroku/Netlify alternative.
This MCP server enables AI assistants like Claude to manage your Coolify infrastructure, including servers, projects, applications, databases, services, and more.
Compatibility
Works with both:
- Coolify Cloud - cloud.coolify.io
- Coolify Self-Hosted - Any self-hosted Coolify instance (v4.x)
Features
- 98 tools covering the complete Coolify API
- Full CRUD operations for all Coolify resources
- Database backup management
- GitHub App integrations
- Deployment management and monitoring
- Environment variable management
- Works with Coolify Cloud and self-hosted instances
- Easy one-command installation via npx
Installation
Using npx (recommended)
npx coolify-mcp-tools
Global installation
npm install -g coolify-mcp-tools
coolify-mcp
From source
git clone https://github.com/jplansink/coolify-mcp-tools.git
cd coolify-mcp-tools
npm install
npm run build
Configuration
Environment Variables
| Variable | Required | Description |
|---|---|---|
COOLIFY_BASE_URL | Yes | Your Coolify instance URL (see examples below) |
COOLIFY_ACCESS_TOKEN | Yes | API access token from Coolify |
Base URL Examples:
- Coolify Cloud:
https://app.coolify.io - Self-hosted:
https://coolify.yourdomain.com(your Coolify URL)
Getting Your Coolify Access Token
- Log into your Coolify instance (Cloud or self-hosted)
- Go to Settings > API
- Enable the API if not already enabled
- Click Create New Token
- Give it a name (e.g., "MCP Server")
- Copy the generated token
Claude Desktop Configuration
Add this to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": ["coolify-mcp-tools"],
"env": {
"COOLIFY_BASE_URL": "https://your-coolify-instance.com",
"COOLIFY_ACCESS_TOKEN": "your-api-token-here"
}
}
}
}
Claude Code (CLI) Configuration
Add this to your Claude Code settings file:
macOS/Linux: ~/.claude/settings.json
Windows: %USERPROFILE%\.claude\settings.json
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": ["coolify-mcp-tools"],
"env": {
"COOLIFY_BASE_URL": "https://your-coolify-instance.com",
"COOLIFY_ACCESS_TOKEN": "your-api-token-here"
}
}
}
}
Available Tools
Servers (8 tools)
list_servers- List all Coolify serversget_server- Get server detailscreate_server- Create a new serverupdate_server- Update server configurationdelete_server- Delete a serverget_server_resources- Get resources running on a serverget_server_domains- Get domains configured on a servervalidate_server- Validate server connection
Projects (9 tools)
list_projects- List all projectsget_project- Get project detailscreate_project- Create a new projectupdate_project- Update projectdelete_project- Delete a projectget_project_environment- Get environment detailslist_project_environments- List all environmentscreate_project_environment- Create new environmentdelete_project_environment- Delete an environment
Applications (21 tools)
list_applications- List all applicationsget_application- Get application detailscreate_public_application- Create from public git repocreate_private_ghapp_application- Create from private GitHub App repocreate_private_deploykey_application- Create from private repo with deploy keycreate_dockerfile_application- Create from Dockerfilecreate_dockerimage_application- Create from Docker imagecreate_dockercompose_application- Create from Docker Composeupdate_application- Update applicationdelete_application- Delete applicationstart_application- Start applicationstop_application- Stop applicationrestart_application- Restart applicationdeploy_application- Deploy applicationget_application_logs- Get application logsexecute_application_command- Execute command in containerlist_application_envs- List environment variablescreate_application_env- Create environment variableupdate_application_env- Update environment variablebulk_update_application_envs- Bulk update environment variablesdelete_application_env- Delete environment variable
Databases (21 tools)
list_databases- List all databasesget_database- Get database detailsupdate_database- Update databasedelete_database- Delete databasecreate_postgres_database- Create PostgreSQL databasecreate_mysql_database- Create MySQL databasecreate_mariadb_database- Create MariaDB databasecreate_mongodb_database- Create MongoDB databasecreate_redis_database- Create Redis databasecreate_keydb_database- Create KeyDB databasecreate_clickhouse_database- Create Clickhouse databasecreate_dragonfly_database- Create Dragonfly databasestart_database- Start databasestop_database- Stop databaserestart_database- Restart databaselist_database_backups- List backup configurationscreate_database_backup- Create backup configurationupdate_database_backup- Update backup configurationdelete_database_backup- Delete backup configurationlist_backup_executions- List backup executionsdelete_backup_execution- Delete backup execution
Services (16 tools)
list_services- List all one-click servicesget_service- Get service detailscreate_service- Create a one-click service (WordPress, n8n, etc.)update_service- Update servicedelete_service- Delete servicestart_service- Start servicestop_service- Stop servicerestart_service- Restart servicelist_service_envs- List environment variablescreate_service_env- Create environment variableupdate_service_env- Update environment variablebulk_update_service_envs- Bulk update environment variablesdelete_service_env- Delete environment variable
GitHub Apps (6 tools)
list_github_apps- List GitHub App integrationscreate_github_app- Create GitHub App integrationupdate_github_app- Update GitHub Appdelete_github_app- Delete GitHub Applist_github_app_repositories- List accessible repositorieslist_github_app_branches- List repository branches
Private Keys (5 tools)
list_private_keys- List all private keysget_private_key- Get private key detailscreate_private_key- Create a new private keyupdate_private_key- Update private keydelete_private_key- Delete private key
Teams (5 tools)
list_teams- List all teamsget_team- Get team detailsget_team_members- Get team membersget_current_team- Get current authenticated teamget_current_team_members- Get current team members
Deployments (5 tools)
list_deployments- List running deploymentsget_deployment- Get deployment detailsget_deployments_by_application- Get deployments for an applicationcancel_deployment- Cancel a deploymentdeploy- Deploy by tag or UUID
Utility (5 tools)
list_resources- List all resourcesget_version- Get Coolify versionhealthcheck- Check API healthenable_api- Enable Coolify APIdisable_api- Disable Coolify API
Supported One-Click Services
The create_service tool supports 80+ one-click services including:
- CMS: WordPress, Ghost, Directus, Strapi
- Automation: n8n, Activepieces
- Analytics: Umami, Posthog, Metabase
- Collaboration: Nextcloud, Penpot, Mattermost
- Development: Gitea, Code Server, Docker Registry
- Monitoring: Uptime Kuma, Grafana, Glances
- And many more...
Usage Examples
Once configured, you can ask Claude to:
- "List all my Coolify servers"
- "Create a new PostgreSQL database in my production project"
- "Deploy my application and show me the logs"
- "Set up a new WordPress site with MySQL"
- "Show me all running deployments"
- "Create a backup schedule for my database"
Development
# Install dependencies
npm install
# Build
npm run build
# Run tests
npm test
# Lint
npm run lint
# Format code
npm run format
Contributing
Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
License
MIT License - see LICENSE for details.
Links
- Coolify - The self-hosting platform
- Coolify API Docs - Official API documentation
- Model Context Protocol - MCP specification
- Claude Desktop - AI assistant with MCP support