Skip to main content
Glama
kof70

Coolify MCP Server

by kof70
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Coolify MCP Server

npm version License: MIT Node.js Version

A Model Context Protocol (MCP) server for Coolify API integration. Control your self-hosted PaaS directly from Claude, Kiro, or any MCP-compatible AI assistant.

🚀 Features

  • Complete API Coverage: Applications, Databases, Servers, Projects, Services, Teams, Deployments, Private Keys

  • MCP Resources: Direct resource access via coolify:// URIs

  • Version Detection: Automatic feature compatibility based on Coolify version

  • Rate Limiting: Built-in rate limit handling with retry logic

  • Minimal Dependencies: Only axios and MCP SDK

  • TypeScript: Full type safety

📦 Installation

From npm (recommended)

npm install -g coolify-mcp-server

From source

git clone https://github.com/YOUR_USERNAME/coolify-mcp-server.git cd coolify-mcp-server npm install npm run build

⚙️ Configuration

Environment Variables

Variable

Required

Description

COOLIFY_BASE_URL

Yes

Your Coolify instance URL (e.g.,

https://coolify.example.com

)

COOLIFY_TOKEN

Yes

API token from Coolify

COOLIFY_TEAM_ID

No

Team ID for multi-team setups

Getting an API Token

  1. Go to your Coolify instance

  2. Navigate to Keys & Tokens → API tokens

  3. Create a new token with required permissions:

    • read - For listing resources

    • write - For creating/updating resources

    • deploy - For deployment operations

🔧 Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{ "mcpServers": { "coolify": { "command": "coolify-mcp", "env": { "COOLIFY_BASE_URL": "https://your-coolify.com", "COOLIFY_TOKEN": "your-api-token" } } } }

With Kiro

Add to your .kiro/settings/mcp.json:

{ "mcpServers": { "coolify": { "command": "coolify-mcp", "env": { "COOLIFY_BASE_URL": "https://your-coolify.com", "COOLIFY_TOKEN": "your-api-token" } } } }

From Source

{ "mcpServers": { "coolify": { "command": "node", "args": ["/path/to/coolify-mcp-server/build/index.js"], "env": { "COOLIFY_BASE_URL": "https://your-coolify.com", "COOLIFY_TOKEN": "your-api-token" } } } }

🛠️ Available Tools

Version & Health

Tool

Description

get_version

Get Coolify version information

health_check

Check API health status

Teams

Tool

Description

list_teams

List all accessible teams

get_team

Get team details by ID

get_current_team

Get current team details

get_current_team_members

Get current team members

Servers

Tool

Description

list_servers

List all servers

create_server

Create a new server

validate_server

Validate server connection

get_server_resources

Get server resource usage

get_server_domains

Get server domains

Projects & Environments

Tool

Description

list_projects

List all projects

get_project

Get project details

create_project

Create a new project

list_environments

List project environments

create_environment

Create a new environment

Applications

Tool

Description

list_applications

List all applications

get_application

Get application details

create_application

Create a new application

start_application

Start an application

stop_application

Stop an application

restart_application

Restart an application

deploy_application

Deploy an application

execute_command

Execute command in container

get_application_logs

Get application logs

Services

Tool

Description

list_services

List all services

create_service

Create a new service

start_service

Start a service

stop_service

Stop a service

restart_service

Restart a service

Databases

Tool

Description

list_databases

List all databases

create_database

Create a new database (PostgreSQL, MySQL, MongoDB, Redis)

Deployments

Tool

Description

list_deployments

List all deployments

get_deployment

Get deployment details

Private Keys

Tool

Description

list_private_keys

List all SSH private keys

create_private_key

Create a new SSH private key

📚 MCP Resources

Access data directly via MCP resources:

coolify://applications - List all applications coolify://databases - List all databases coolify://servers - List all servers coolify://projects - List all projects coolify://services - List all services coolify://teams - List all teams coolify://deployments - List all deployments coolify://private-keys - List all private keys

💡 Example Prompts

Once configured, you can ask your AI assistant:

  • "List all my Coolify applications"

  • "Deploy the app with UUID abc123"

  • "Show me the logs for my-app"

  • "Create a new PostgreSQL database called mydb"

  • "What servers do I have in Coolify?"

  • "Restart the production application"

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'feat: add amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

📮 Support

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kof70/coolify-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server