Overview
What is Coolify Mcp?
A Model Context Protocol (MCP) server for Coolify that lets AI assistants manage Coolify instances through natural language commands.
How to use Coolify Mcp?
Install with npx -y @masonator/coolify-mcp after setting the required environment variables COOLIFY_ACCESS_TOKEN and COOLIFY_BASE_URL. Configure the server in MCP-compatible clients like Claude Desktop or Cursor by providing the command and token.
Key features of Coolify Mcp
- Manage servers: list, inspect, monitor resources
- Manage projects: create, update, delete, list
- Manage applications: create, delete, inspect
- Manage databases: create, update, delete (PostgreSQL, Redis, MongoDB, MySQL)
- Manage deployments: list, status, deploy, rebuild
- Manage services: create (WordPress, etc.), status, delete
Use cases of Coolify Mcp
- Ask your AI assistant to list all servers and their resource usage
- Create a new project and set up environments via chat
- Deploy an application and check deployment status
- Set up a PostgreSQL database and configure its memory limit
- Inspect details of a running service or database
FAQ from Coolify Mcp
What are the prerequisites?
Node.js 18 or later, a running Coolify instance, and a Coolify API access token.
How do I configure environment variables?
Set COOLIFY_ACCESS_TOKEN (required) and optionally COOLIFY_BASE_URL (defaults to http://localhost:3000).
What resource types does Coolify Mcp support?
Application, Service (e.g., WordPress with MySQL), Database (PostgreSQL, MySQL, MongoDB, Redis), and Deployment.
How can I contribute?
Submit a Pull Request; open an issue first for major changes.
How do I run the server locally?
Clone the repository, run npm install, build with npm run build, and test with npm test.
