io.github.mariomorenodev/rundeck-mcp-server

rundeck-mcp-server

The most comprehensive MCP (Model Context Protocol) server for Rundeck. Manage jobs, executions, projects, nodes, and more from Claude, Cursor, or any MCP-compatible client.

50 tools across 7 domains — full CRUD operations, execution monitoring, and system management.

Features

• Projects — List, create, delete, and configure projects
• Jobs — List, create, run, retry, import/export, enable/disable execution and scheduling
• Executions — Monitor running jobs, get logs, abort executions, query history
• Nodes — Browse node inventory with filter expressions
• System — Server info, health checks, metrics, execution mode control
• Key Storage — Manage secrets, passwords, and SSH keys
• Webhooks — Create and manage webhook triggers
• ACL Policies — Full CRUD for system access control policies

Quick Start

Prerequisites

• Node.js 18+
• A Rundeck instance with API access
• A Rundeck API token (how to generate one)

Using with Claude Code

Add to your MCP settings:

{
  "mcpServers": {
    "rundeck": {
      "command": "npx",
      "args": ["-y", "rundeck-mcp-server"],
      "env": {
        "RUNDECK_URL": "http://your-rundeck-server:4440",
        "RUNDECK_API_TOKEN": "your-api-token"
      }
    }
  }
}

Using with Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "rundeck": {
      "command": "npx",
      "args": ["-y", "rundeck-mcp-server"],
      "env": {
        "RUNDECK_URL": "http://your-rundeck-server:4440",
        "RUNDECK_API_TOKEN": "your-api-token"
      }
    }
  }
}

Using with Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "rundeck": {
      "command": "npx",
      "args": ["-y", "rundeck-mcp-server"],
      "env": {
        "RUNDECK_URL": "http://your-rundeck-server:4440",
        "RUNDECK_API_TOKEN": "your-api-token"
      }
    }
  }
}

Configuration

Available Tools

Projects (6 tools)

Jobs (14 tools)

Executions (8 tools)

Nodes (2 tools)

System (12 tools)

Key Storage (4 tools)

Webhooks (4 tools)

Usage Examples

Once configured, you can interact with Rundeck using natural language:

• "List all projects in Rundeck"
• "Show me the running executions in the production project"
• "Run the deploy-app job in the staging project with version=2.1.0"
• "Get the logs from execution 1234"
• "Abort execution 5678"
• "Show me all failed executions in the last 24 hours"
• "List the nodes tagged as 'web' in the production project"
• "Check the Rundeck server health"
• "Disable the cleanup job schedule"

Development

# Clone the repository
git clone https://github.com/mariomorenodev/rundeck-mcp-server.git
cd rundeck-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
RUNDECK_URL=http://localhost:4440 RUNDECK_API_TOKEN=your-token npm run dev

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m '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 Apache License 2.0 — see the LICENSE file for details.