CoolifyMCP

A comprehensive Model Context Protocol (MCP) server that provides complete access to all Coolify API endpoints. CoolifyMCP enables AI assistants to interact with Coolify for managing applications, databases, servers, deployments, and more.

Built for Coolify - An open-source & self-hostable Heroku / Netlify / Vercel alternative

✨ Features

• 🎯 100% API Coverage: Complete implementation of all Coolify API endpoints
• 🛠️ 18 Consolidated MCP Tools: Streamlined access to Coolify's functionality through MCP protocol
• 🔒 Type Safety: Built with TypeScript for robust error handling and development experience
• 🚀 Production Ready: Health checks, proper logging, and monitoring
• �� NPM Distribution: Easy installation via npx coolifymcp

🚀 Quick Start

Install in Your AI IDE

CoolifyMCP works with all major AI IDEs that support the Model Context Protocol (MCP):

Cursor IDE (Recommended)

1. Open Cursor and go to Settings → Extensions → MCP
2. Add this configuration to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "coolifymcp": {
      "command": "npx",
      "args": ["coolifymcp"],
      "env": {
        "COOLIFY_API_TOKEN": "your_coolify_api_token_here",
        "COOLIFY_BASE_URL": "https://your-coolify-instance.com/api/v1"
      }
    }
  }
}

Claude Desktop

1. Open Claude Desktop settings
2. Add the same configuration to your MCP settings

JetBrains AI Assistant

1. Open your JetBrains IDE (IntelliJ, WebStorm, etc.)
2. Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)
3. Click "Add" and configure:
   • Name: coolifymcp
   • Command: npx
   • Arguments: ["coolifymcp"]
   • Environment Variables:
     • COOLIFY_API_TOKEN: your_coolify_api_token_here
     • COOLIFY_BASE_URL: https://your-coolify-instance.com/api/v1

Other MCP-Compatible IDEs

• LibreChat: Add MCP server configuration in settings
• Klavis AI: Configure in your platform's MCP settings
• Custom MCP Clients: Use the same configuration format

🎯 Available Tools

The Coolify MCP Server provides 18 consolidated tools that cover all Coolify functionality:

System Management (1 tool)

• coolify_system - System health, version, and information management

Team Management (1 tool)

• coolify_teams - Complete team management operations

Project Management (2 tools)

• coolify_projects - Project CRUD operations
• coolify_project_environments - Project environment management

Application Management (5 tools)

• coolify_applications - Application CRUD operations (all types)
• coolify_application_lifecycle - Application lifecycle management
• coolify_application_envs - Application environment variables
• coolify_logs - Application logs retrieval
• coolify_application_deployments - Application deployment management

Database Management (3 tools)

• coolify_databases - Database CRUD operations
• coolify_database_lifecycle - Database lifecycle management
• coolify_database_types - Specific database type creation

Server Management (2 tools)

• coolify_servers - Server CRUD operations
• coolify_server_management - Server operations and resources

Service Management (3 tools)

• coolify_services - Service CRUD operations
• coolify_service_lifecycle - Service lifecycle management
• coolify_service_envs - Service environment variables

Security Management (1 tool)

• coolify_security_keys - Security key management

�� Prerequisites

• Node.js 20+ - Download
• npm 9+ or yarn - Package manager
• Coolify API token - Get from your Coolify dashboard
• Coolify instance URL - Your Coolify instance (default: https://app.coolify.io/api/v1)

🔧 Configuration

Environment Variables

�� Key Benefits

• Reduced Complexity: 18 tools instead of 83+ individual tools
• Better Performance: Fewer tool definitions and cleaner API calls
• Easier Maintenance: Action-based parameters for better organization
• Simplified Documentation: Clear tool categories and actions
• 100% API Coverage: All Coolify endpoints accessible through consolidated interface

📚 Documentation

• GitHub Repository - Source code and issue tracking
• Coolify Documentation - Official Coolify platform docs

📞 Support

For issues and questions:

• 📝 Create an issue in the repository
• �� Check the Coolify documentation
• �� Join the Coolify community

🙏 Acknowledgments

This project is built for and powered by Coolify - an amazing open-source platform that makes self-hosting applications incredibly easy. Special thanks to the Coolify team and community for creating such a powerful tool.

Built with ❤️ for the Coolify community