rundeck-mcp-server
Provides tools for managing Rundeck projects, jobs, and executions via the Rundeck API.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@rundeck-mcp-serverlist jobs in my 'Infrastructure' project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Rundeck MCP Server
A Model Context Protocol (MCP) server for Rundeck, enabling AI assistants to manage projects, jobs, and executions through a standardized interface.
Prerequisites
Python 3.12+
uv package manager
A Rundeck instance with API access
A Rundeck API Token (generate under User Profile > API Tokens in the Rundeck UI)
Related MCP server: now-sdk-ext-mcp
Quick Start
Install and run directly with uvx (no clone needed):
uvx rundeck-mcp --enable-write-toolsOr install from GitHub:
uv pip install git+https://github.com/justynroberts/rundeck-mcp-server.gitEnvironment Variables
Variable | Required | Default | Description |
| Yes | - | Rundeck API authentication token |
| No |
| Rundeck server base URL |
| No |
| Rundeck API version |
MCP Client Configuration
Claude Code
From a local clone:
git clone https://github.com/justynroberts/rundeck-mcp-server.git
claude mcp add rundeck \
-e RUNDECK_API_TOKEN=<your-api-token> \
-e RUNDECK_URL=http://your-rundeck-server:4440 \
-- uv run --directory /path/to/rundeck-mcp-server rundeck-mcp --enable-write-toolsOr add manually to ~/.claude/settings.json:
{
"mcpServers": {
"rundeck": {
"command": "uv",
"args": [
"run", "--directory", "/path/to/rundeck-mcp-server",
"rundeck-mcp", "--enable-write-tools"
],
"env": {
"RUNDECK_API_TOKEN": "<your-api-token>",
"RUNDECK_URL": "http://your-rundeck-server:4440"
}
}
}
}From PyPI (once published):
claude mcp add rundeck \
-e RUNDECK_API_TOKEN=<your-api-token> \
-e RUNDECK_URL=http://your-rundeck-server:4440 \
-- uvx rundeck-mcp --enable-write-toolsClaude Desktop
Add to your Claude Desktop MCP configuration:
{
"mcpServers": {
"rundeck": {
"command": "uvx",
"args": ["rundeck-mcp", "--enable-write-tools"],
"env": {
"RUNDECK_API_TOKEN": "<your-api-token>",
"RUNDECK_URL": "http://your-rundeck-server:4440"
}
}
}
}Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"rundeck": {
"command": "uvx",
"args": ["rundeck-mcp", "--enable-write-tools"],
"env": {
"RUNDECK_API_TOKEN": "<your-api-token>",
"RUNDECK_URL": "http://your-rundeck-server:4440"
}
}
}
}VS Code
Add to .vscode/mcp.json:
{
"servers": {
"rundeck": {
"command": "uvx",
"args": ["rundeck-mcp", "--enable-write-tools"],
"env": {
"RUNDECK_API_TOKEN": "<your-api-token>",
"RUNDECK_URL": "http://your-rundeck-server:4440"
}
}
}
}Local Development
git clone https://github.com/justynroberts/rundeck-mcp-server.git
cd rundeck-mcp-server
uv sync --group devRun tests
uv run pytestLint and type check
uv run ruff check .
uv run pyrightRun locally
export RUNDECK_API_TOKEN=<your-token>
export RUNDECK_URL=http://localhost:4440
uv run rundeck-mcp --enable-write-toolsAvailable Tools
Read Tools (always available)
Tool | Description |
| List all Rundeck projects |
| Get details for a specific project |
| List jobs in a project with optional filtering |
| Get full job definition including options and steps |
| Get current status of a job execution |
| List recent executions for a job |
| Get log output from an execution |
Write Tools (require --enable-write-tools)
Tool | Description |
| Create a new Rundeck project |
| Import a job from YAML definition |
| Delete a job |
| Execute a job with optional parameters |
| Abort a running execution |
Job Execution Workflow
The server enforces a safe execution pattern:
Discover: Use
get_jobto retrieve the job definition and its optionsPresent: The AI presents option names, descriptions, defaults, required flags, and allowed values to the user
Collect: The user provides values for required and desired optional parameters
Execute:
run_jobis called with the collected option valuesMonitor: Use
get_executionandget_execution_outputto track progress
License
MIT License - Copyright (c) fintonlabs.com
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceAn MCP server that enables remote SSH command execution and bidirectional file transfers through a standardized interface. It allows AI assistants to securely manage remote servers while keeping credentials isolated and applying command-level security controls.Last updatedISC
- AlicenseAqualityAmaintenanceAn MCP server that enables AI assistants to interact with ServiceNow instances, allowing script execution, data querying, ATF tests, and log tailing through natural language commands.Last updated8738113MIT
- Alicense-qualityBmaintenanceEnterprise-grade MCP server exposing Ansible Automation Platform 2.x as a complete AI interface for LLMs, enabling natural language management of automation resources.Last updated1Apache 2.0
- Alicense-qualityCmaintenanceMCP server for network operations that lets AI assistants interact with Cisco/Juniper network devices through safe, well-defined tools like compliance audits and configuration backups.Last updatedMIT
Related MCP Connectors
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
MCP Hub: AI service discovery, per-user OAuth, and multi-service workflow orchestration
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/justynroberts/rundeck-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server