Select your language

CronManager MCP Server

Control CronManager through Claude Desktop or Claude Code using natural language. The official MCP server exposes 20+ tools for job management, execution control, and maintenance windows — no manual UI interaction required.

What you can do with it

🗣️

Natural Language Control

Ask Claude to show failed jobs, disable a job, create a maintenance window, or export a tag — and it happens immediately, without opening the web UI.

🔧

20+ Tools

Full coverage: list, create, update, delete jobs. Get execution history, trigger runs, kill executions. Manage maintenance windows, export jobs, read and write settings.

🔒

Secure by Design

The MCP server sits between Claude and your CronManager instance. Your API key is never exposed to Claude clients. The MCP endpoint is protected by a separate Bearer Token.

👁️

Read-Only Mode

Set MCP_READONLY_MODE=true to expose only read-only tools — safe for giving Claude visibility without allowing any changes.

🤖

Multi-Agent Aware

Optionally set CM_AGENT_ID to target a specific CronManager agent. Manage jobs on different servers through a single MCP server instance.

🐳

Docker-Ready

Pre-built image on Docker Hub. Up and running in minutes — no Node.js installation required on the host.

Quick Start

Deploy in One Command

docker run -d \
  -e CM_BASE_URL=https://cronmanager.example.com \
  -e CM_API_KEY=cm_your_api_key_here \
  -e MCP_AUTH_TOKEN=your_mcp_auth_token_here \
  -p 3000:3000 \
  cs1711/cronmanager-mcp:latest

Requires a CronManager API key (v4.1.0+). Generate one in Settings → API Keys.

Example Prompts

🔍

Monitoring

"Show me all failed jobs from the last 24 hours"
"Which jobs ran longer than 5 minutes today?"

⚙️

Job Control

"Disable job 42"
"Run the backup job now and show me the output"
"Kill the stuck database job"

🛠️

Maintenance

"Create a maintenance window for Sunday night at 2 AM, lasting 2 hours"
"List all active maintenance windows"

📤

Export & Settings

"Export all jobs tagged 'backup' as JSON"
"What are the current notification settings?"

Available Tool Scopes

📋

jobs:read

List jobs, get job details, execution history, timeline statistics, tags.

✏️

jobs:write

Create, update, and delete jobs.

▶️

jobs:execute

Trigger immediate job execution and kill running executions.

📤

export:read

Export jobs as crontab or JSON.

🛠️

maintenance:read/write

List, create, update, and delete maintenance windows.

⚙️

settings:read/write

Read and update application settings. Resync crontab.

View full documentation on GitHub →