MCP server for Rundeck — 50 tools to manage jobs, executions, projects, nodes, and system from Claude Code, Cursor, or any MCP client
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add rundeck --env RUNDECK_URL='<RUNDECK_URL>' --env RUNDECK_API_TOKEN='<RUNDECK_API_TOKEN>' -- npx -y rundeck-mcp-server~/.codex/config.toml
[mcp_servers.rundeck]
command = "npx"
args = ["-y", "rundeck-mcp-server"]
env = { RUNDECK_URL = "<RUNDECK_URL>", RUNDECK_API_TOKEN = "<RUNDECK_API_TOKEN>" }
# codex mcp add rundeck --env RUNDECK_URL='<RUNDECK_URL>' --env RUNDECK_API_TOKEN='<RUNDECK_API_TOKEN>' -- npx -y rundeck-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"rundeck": {
"command": "npx",
"args": [
"-y",
"rundeck-mcp-server"
],
"env": {
"RUNDECK_URL": "<RUNDECK_URL>",
"RUNDECK_API_TOKEN": "<RUNDECK_API_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"rundeck": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"rundeck-mcp-server"
],
"env": {
"RUNDECK_URL": "<RUNDECK_URL>",
"RUNDECK_API_TOKEN": "<RUNDECK_API_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"rundeck": {
"command": "npx",
"args": [
"-y",
"rundeck-mcp-server"
],
"env": {
"RUNDECK_URL": "<RUNDECK_URL>",
"RUNDECK_API_TOKEN": "<RUNDECK_API_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"rundeck": {
"command": "npx",
"args": [
"-y",
"rundeck-mcp-server"
],
"env": {
"RUNDECK_URL": "<RUNDECK_URL>",
"RUNDECK_API_TOKEN": "<RUNDECK_API_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"rundeck": {
"command": "npx",
"args": [
"-y",
"rundeck-mcp-server"
],
"env": {
"RUNDECK_URL": "<RUNDECK_URL>",
"RUNDECK_API_TOKEN": "<RUNDECK_API_TOKEN>"
}
}
}
}Environment variables
RUNDECK_URLRUNDECK_API_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.