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.