Skip to content
MCP server

Rundeck

MCP server that lets AI clients drive Rundeck runbook automation and job scheduling

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About Rundeck

Rundeck is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The README describes this as a Model Context Protocol server that connects Rundeck, an runbook automation and job scheduling platform, to GenAI applications. It is distributed as a Python package on PyPI and can also be installed from source, with configuration handled through environment variables or a .env file that holds the Rundeck API URL and API key.

Once running over stdio, the server is meant to expose Rundeck's API to an AI client. The README lists broad API coverage, several authentication methods, rate limiting, retry handling and async support, though it does not enumerate the individual tools it exposes.

The listing suits teams that already use Rundeck for operations runbooks and want an assistant to inspect or trigger jobs through the same API. The project is released under the MIT licence.

Install

Run in a terminal

claude mcp add rundeck-mcp-server --env RUNDECK_API_KEY='<RUNDECK_API_KEY>' -- uvx rundeck-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "rundeck-mcp-server": {
      "command": "uvx",
      "args": [
        "rundeck-mcp-server"
      ],
      "env": {
        "RUNDECK_API_KEY": "<RUNDECK_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "rundeck-mcp-server": {
      "command": "uvx",
      "args": [
        "rundeck-mcp-server"
      ],
      "env": {
        "RUNDECK_API_KEY": "<RUNDECK_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "rundeck-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "rundeck-mcp-server"
      ],
      "env": {
        "RUNDECK_API_KEY": "<RUNDECK_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "rundeck-mcp-server": {
      "command": "uvx",
      "args": [
        "rundeck-mcp-server"
      ],
      "env": {
        "RUNDECK_API_KEY": "<RUNDECK_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "rundeck-mcp-server": {
      "command": "uvx",
      "args": [
        "rundeck-mcp-server"
      ],
      "env": {
        "RUNDECK_API_KEY": "<RUNDECK_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • RUNDECK_API_KEYAPI Key for RUNDECKRequired
  • RUNDECK_API_URLAPI URL for RUNDECK

What it does

Rundeck API coverage
Wraps a broad set of Rundeck API endpoints for use from MCP-compatible AI clients.
Multiple authentication methods
Supports more than one way of authenticating against the Rundeck API.
Rate limiting and retries
Includes rate limiting and retry logic for calls to the Rundeck server.
Async operation
Offers asynchronous support intended to improve performance on API calls.
Environment-based configuration
Reads the Rundeck URL and API key from environment variables or a .env file.

Good for

  • Letting an AI assistant check the status of Rundeck jobs
  • Triggering existing Rundeck runbooks from a chat-based workflow
  • Querying Rundeck job configuration while troubleshooting operations

Pricing

Open source

Free and open source under the MIT License.

Rundeck FAQ

How is the server installed?

The README gives the command pip install rundeck-mcp-server, and also describes installing from a cloned repository with pip install -e.

What configuration does it need?

The registry entry lists RUNDECK_API_KEY as a required secret and RUNDECK_API_URL as an optional variable pointing to the Rundeck API.

What license is it under?

The README states it is released under the MIT License.

Is Rundeck free?

Yes. Rundeck is open source, so you can use and self-host it for free.

How do I add Rundeck to Claude Code?

Run this command in your terminal: claude mcp add rundeck-mcp-server --env RUNDECK_API_KEY='<RUNDECK_API_KEY>' -- uvx rundeck-mcp-server

What are the best alternatives to Rundeck?

The closest alternatives to Rundeck are Uipath, Harness, RunCloud MCP by usefulapi, MCP Acedatacloud and McpMux.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers