Coolify MCP Server

An MCP server for integrating with Coolify, the self-hostable alternative to Netlify and Vercel.

A robust TypeScript MCP (Model Context Protocol) server for integrating with Coolify, the self-hostable alternative to Netlify and Vercel.

- Complete Coolify API Integration: Manage applications, databases, servers, projects, and services
- Type-Safe: Full TypeScript support with comprehensive type definitions
- MCP Protocol: Compatible with Claude and other MCP clients
- Resource Access: Expose Coolify resources through MCP resource endpoints
- Tool Support: Comprehensive set of tools for Coolify operations

The server requires environment variables to connect to your Coolify instance:

export COOLIFY_API_URL="http://localhost:8000" export COOLIFY_API_TOKEN="your-api-token-here" export COOLIFY_TEAM_ID="optional-team-id" # Optional

COOLIFY_API_URL=http://localhost:8000 COOLIFY_API_TOKEN=your-api-token-here COOLIFY_TEAM_ID=optional-team-id

Add the server to your Claude Desktop configuration file:

macOS:~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "coolify": { "command": "node", "args": ["/path/to/coolify-mcp-server/dist/index.js"], "env": { "COOLIFY_API_URL": "http://localhost:8000", "COOLIFY_API_TOKEN": "your-api-token-here", "COOLIFY_TEAM_ID": "optional-team-id" } } } }

If you publish to npm, users can run via npx:

{ "mcpServers": { "coolify": { "command": "npx", "args": ["@joshuarileydev/coolify-mcp-server", "--yes"], "env": { "COOLIFY_API_URL": "http://localhost:8000", "COOLIFY_API_TOKEN": "your-api-token-here", "COOLIFY_TEAM_ID": "optional-team-id" } } } }

{ "mcpServers": { "coolify": { "command": "npx", "args": ["coolify-mcp-server", "--yes"], "env": { "COOLIFY_API_URL": "http://localhost:8000", "COOLIFY_API_TOKEN": "your-api-token-here", "COOLIFY_TEAM_ID": "optional-team-id" } } } }

For development, you can use the TypeScript source directly:

{ "mcpServers": { "coolify": { "command": "npx", "args": ["tsx", "/path/to/coolify-mcp-server/src/index.ts"], "env": { "COOLIFY_API_URL": "http://localhost:8000", "COOLIFY_API_TOKEN": "your-api-token-here", "COOLIFY_TEAM_ID": "optional-team-id" } } } }

For other MCP clients that support environment variables, ensure the following variables are set:

- COOLIFY_API_URL(required)
- COOLIFY_API_TOKEN(required)
- COOLIFY_TEAM_ID(optional)

#!/bin/bash export COOLIFY_API_URL="http://localhost:8000" export COOLIFY_API_TOKEN="your-api-token-here" export COOLIFY_TEAM_ID="your-team-id" node /path/to/coolify-mcp-server/dist/index.js

- list_applications- List all applications
- get_application- Get application details
- create_application- Create new application
- start_application- Start an application
- stop_application- Stop an application
- restart_application- Restart an application
- deploy_application- Deploy an application

- list_databases- List all databases
- create_database- Create new database

- list_servers- List all servers
- create_server- Create new server
- validate_server- Validate server connection

- list_projects- List all projects
- create_project- Create new project

- list_services- List all services
- start_service- Start a service
- stop_service- Stop a service

- coolify://applications- All applications
- coolify://databases- All databases
- coolify://servers- All servers
- coolify://projects- All projects
- coolify://services- All services
- coolify://teams- All teams
- Log into your Coolify instance
- Navigate to "Keys & Tokens" > "API tokens"
- Click "Create New Token"
- Choose appropriate permissions:

- read-only: Read data only
- read:sensitive: Read with sensitive data
- *: Full access (recommended for MCP server)

When using the MCP server with Claude Desktop or other clients, your API token will be stored in the configuration file. Ensure this file has appropriate permissions:

# macOS/Linux chmod 600 ~/Library/Application\ Support/Claude/claude_desktop_config.json # Or set environment variables in your shell profile instead echo 'export COOLIFY_API_TOKEN="your-token-here"' >> ~/.bashrc

# Install dependencies npm install # Run in development mode (requires env vars) COOLIFY_API_URL=http://localhost:8000 COOLIFY_API_TOKEN=your-token npm run dev # Build for production npm run build # Run built version npm start # Lint code npm run lint # Type check npm run typecheck

-

"COOLIFY_API_URL and COOLIFY_API_TOKEN environment variables are required"

- Ensure environment variables are set before starting the server
- Check that your.envfile is in the correct location
- Verify variable names are spelled correctly

"Tool execution failed: Request failed"

- Verify your Coolify instance is running and accessible
- Check that the API URL is correct (include protocol:http://orhttps://)
- Ensure your API token has the necessary permissions

MCP server not appearing in Claude Desktop

- Restart Claude Desktop after updating configuration
- Check the configuration file path is correct for your OS
- Verify JSON syntax in the configuration file

To see detailed error messages, run the server with debug output:

Create, build, deploy, and manage Netlify resources using natural language.

Integrate with the Coolify API to manage your servers, applications, and databases.

An MCP server for interacting with the Coolify API to manage servers and applications.

Integrate with the Laravel Forge API to manage servers and deployments using MCP-compliant tools.

An MCP server for managing Modal apps, containers, volumes, and secrets. It also helps in deploying & running Modal apps directly from Claude Code and other MCP clients.

Interact with Modal volumes and deploy Modal applications from within Cursor.

An MCP server providing comprehensive access to Netlify's features and services.

Multi-cloud deployment MCP server — deploy to Cloudflare Pages, Vercel, or Netlify from a single tool with 26 MCP tools.

The remote MCP bridge that lets any AI agent deploy, manage, and scale applications to Cloudflare, Netlify, or Vercel.

Deploy static sites and Next.js apps from any AI editor with one command — 46 MCP tools for deployment, domains, and team sharing.