English Français العربية

io.github.takeaseatventure/cron-mcp

Registre officiel IA et agents

MCP cron validator for AI agents; flags impossible schedules and other silent cron bugs.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package cron-mcp-server
Claude Code 
claude mcp add cron-mcp -- npx -y cron-mcp-server@0.1.2
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "cron-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cron-mcp-server@0.1.2"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. cron-mcp
  2. Why
  3. Tools exposed
  4. Install
  5. Published links
  6. Configure
  7. Example usage
  8. Engine
  9. License

cron-mcp

An MCP (Model Context Protocol) server that lets AI coding agents — Claude, Cursor, Copilot, Cline — parse, validate, explain, and preview cron expressions.

Built to catch silent cron bugs (impossible schedules, OR-semantics gotchas, midnight spikes) before a job is deployed — a class of mistake that's easy to make and hard to notice until a critical job silently fails to fire.

Why

Cron expressions are deceptively tricky. Common silent failures:

  • 0 0 30 2 * → never runs (February has no 30th). Syntactically valid, semantically dead.
  • 0 0 1,15 * 1 → fires on the 1st OR 15th OR Monday, not "the 1st and 15th if Monday" (the classic dom+dow OR-semantics trap).
  • */7 * * * * → uneven step; intervals drift (:00, :07, :14, …, :56, :00 — not "every 7 minutes" cleanly).
  • 0 0 * * * → midnight spike; every job in the system competes at 00:00.

cron-mcp surfaces these as warnings, observations, and suggestions that the AI agent can act on — before you ship the schedule.

Tools exposed

ToolDescription
parse_cronParse a cron expression → plain-English description of when it fires. Supports 5-field standard cron + L (last), W (nearest weekday), # (nth weekday), named months/days.
validate_cronDeep validation: impossible schedules, OR-semantics, midnight spikes, uneven steps, leap-year edges, frequency estimate (~runs/year).
next_runsCompute the next N fire times as ISO-8601 + relative offsets.
cron_presetsLibrary of common, proven schedules (every 5 min, hourly, weekdays 9am, monthly, quarterly, …).

Install

npm install -g cron-mcp-server

Configure

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on your OS:

{
  "mcpServers": {
    "cron": {
      "command": "cron-mcp-server",
      "args": []
    }
  }
}
Cursor

Add to .cursor/mcp.json (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "cron": {
      "command": "cron-mcp-server"
    }
  }
}
VS Code (Copilot)
{
  "mcp.servers": {
    "cron": {
      "type": "stdio",
      "command": "cron-mcp-server"
    }
  }
}
Direct (no install)
npx cron-mcp-server

Example usage

Once connected, just ask the agent in natural language:

  • "Validate this cron: 0 0 30 2 *"
  • "When does */5 * * * * next fire?"
  • "Give me a cron for every weekday at 9am"
  • "Is there anything risky about 0 0 1,15 * 1?"

The agent calls the tools and returns structured, actionable results.

Engine

The cron engine is battle-tested: 638 lines, zero dependencies, originally extracted from a browser-based cron generator and hardened with 69 unit tests. This MCP server is a thin tool wrapper around it.

License

MIT © takeaseatventure

Questions fréquentes

Qu'est-ce que io.github.takeaseatventure/cron-mcp ?

MCP cron validator for AI agents; flags impossible schedules and other silent cron bugs.

Comment installer io.github.takeaseatventure/cron-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add cron-mcp -- npx -y cron-mcp-server@0.1.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.takeaseatventure/cron-mcp ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.takeaseatventure/cron-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.takeaseatventure/cron-mcp ?

Il est publié par takeaseatventure. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.