Rundeck Mcp Server

io.github.mariomorenodevPublished by GitHub account mariomorenodevv1.0.3Updated Oct 24, 2026

50 tools to manage Rundeck jobs, executions, projects, nodes, and system via MCP

VerifiedSTDIODesktop onlyCloud & InfrastructureDeveloper ToolsSecurity & Monitoring

Overview

AI-generated overview

A local MCP server that lets an assistant manage a Rundeck instance: projects, jobs, executions, nodes, system settings, key storage, webhooks and ACL policies.

What you can do
List, create, delete and configure projects and their configuration properties, and browse nodes with filter expressions and read node details. List, inspect, run, retry, import, export, delete and bulk-delete jobs, enable or disable job execution and scheduling, and forecast upcoming runs. Query execution history and running executions, read execution details and log output, abort running executions, and delete executions individually or in bulk. Read server info, health, metrics, execution mode, users and log storage, and switch execution mode system-wide. Manage ACL policies and webhooks, and browse, create and delete stored keys, reading key metadata only.
When to use it
Useful when you already run Rundeck for job scheduling and deployment automation and want to drive it conversationally: checking what is running, pulling logs, launching or retrying jobs, and adjusting schedules, projects or policies without the web UI.
Requirements
Runs locally via npx, so Node.js 18 or newer is needed. Requires a reachable Rundeck instance with API access and a Rundeck API token. Set RUNDECK_URL and RUNDECK_API_TOKEN; RUNDECK_API_VERSION (default 41) and RUNDECK_TIMEOUT (default 30000 ms) are optional.
Before you install
The API token grants the assistant whatever rights that Rundeck account has, and many tools change or destroy state: deleting projects, jobs, executions, keys, webhooks and ACL policies, aborting runs, and switching execution mode system-wide. Key storage tools can create and delete secrets, passwords and SSH keys. Point it at a non-production instance first and use a least-privilege token.

Installation

In SourceWeft

  1. Open Rundeck Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

rundeck-mcp-server

[npm version] [License]

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

Using with Claude Code

Add to your MCP settings:

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 Claude Desktop

Add to claude_desktop_config.json:

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):

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

Environment VariableRequiredDefaultDescription
RUNDECK_URLYes—Rundeck server URL (e.g., http://localhost:4440)
RUNDECK_API_TOKENYes—API token for authentication
RUNDECK_API_VERSIONNo41Rundeck API version
RUNDECK_TIMEOUTNo30000Request timeout in milliseconds

Available Tools

Projects (6 tools)

ToolDescription
rundeck_list_projectsList all projects
rundeck_get_projectGet project details and configuration
rundeck_create_projectCreate a new project
rundeck_delete_projectDelete a project permanently
rundeck_get_project_configGet project configuration properties
rundeck_set_project_configUpdate project configuration

Jobs (14 tools)

ToolDescription
rundeck_list_jobsList jobs with filtering by group, name, tags
rundeck_get_jobGet full job definition (steps, options, schedule)
rundeck_get_job_metadataGet job metadata (author, dates)
rundeck_run_jobExecute a job with options and node filters
rundeck_retry_jobRetry a failed execution
rundeck_import_jobsImport jobs from JSON/YAML/XML
rundeck_export_jobsExport job definitions
rundeck_delete_jobDelete a job
rundeck_bulk_delete_jobsDelete multiple jobs at once
rundeck_enable_job_executionEnable job execution
rundeck_disable_job_executionDisable job execution
rundeck_enable_job_scheduleEnable job scheduling
rundeck_disable_job_scheduleDisable job scheduling
rundeck_get_job_forecastGet upcoming scheduled execution times

Executions (8 tools)

ToolDescription
rundeck_list_executionsQuery executions with status and time filters
rundeck_list_running_executionsList currently running executions
rundeck_get_executionGet execution details (status, duration, nodes)
rundeck_get_execution_outputGet execution log output
rundeck_abort_executionAbort a running execution
rundeck_get_job_executionsList execution history for a job
rundeck_delete_job_executionsDelete all executions for a job
rundeck_bulk_delete_executionsDelete multiple executions by ID

Nodes (2 tools)

ToolDescription
rundeck_list_nodesList nodes with filter expressions
rundeck_get_nodeGet node details

System (12 tools)

ToolDescription
rundeck_system_infoServer version, uptime, and system stats
rundeck_get_execution_modeCheck active/passive execution mode
rundeck_set_execution_modeEnable or disable executions system-wide
rundeck_get_metricsServer performance metrics
rundeck_healthcheckSystem health check
rundeck_list_usersList all users
rundeck_get_log_storageLog storage status
rundeck_list_acl_policiesList ACL policy files
rundeck_get_acl_policyGet ACL policy content
rundeck_create_acl_policyCreate ACL policy
rundeck_update_acl_policyUpdate ACL policy
rundeck_delete_acl_policyDelete ACL policy

Key Storage (4 tools)

ToolDescription
rundeck_list_keysBrowse key storage tree
rundeck_get_key_metadataGet key metadata (not the secret value)
rundeck_create_keyStore a password, public key, or private key
rundeck_delete_keyDelete a stored key

Webhooks (4 tools)

ToolDescription
rundeck_list_webhooksList webhooks in a project
rundeck_get_webhookGet webhook details
rundeck_create_webhookCreate a webhook trigger
rundeck_delete_webhookDelete a webhook

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

bash
# Clone the repositorygit clone https://github.com/mariomorenodev/rundeck-mcp-server.gitcd rundeck-mcp-server
# Install dependenciesnpm install
# Buildnpm run build
# Run in development modeRUNDECK_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.

Source: README.md at commit 1a03b0e

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts