Coolify Mcp

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.