@patrick-rodgers/cron-claude 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Patrick Rodgers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,401 @@
+# Cron-Claude MCP Server
+
+**Scheduled Claude task execution via Model Context Protocol**
+
+Cron-Claude is an MCP server that allows you to schedule Claude to perform tasks automatically on a recurring schedule, similar to cron jobs. Tasks are defined in markdown files and managed through MCP tools available in all your Claude Code sessions.
+
+## Features
+
+- 🕐 **Schedule tasks** using familiar cron expressions
+- 🔐 **Audit logging** with HMAC-SHA256 signatures for integrity verification
+- 💾 **Memory integration** - All logs stored via odsp-memory skill
+- 🔔 **Windows notifications** - Optional toast notifications on completion
+- 🎯 **Flexible execution** - Run tasks via Claude CLI or Anthropic API
+- 🛡️ **Windows Task Scheduler** - Reliable, native scheduling that survives reboots
+- 🔌 **MCP Integration** - Seamlessly integrated into all Claude Code sessions
+
+## Installation
+
+### 1. Clone and Build
+
+```bash
+git clone <repository-url>
+cd cron-claude
+npm install
+npm run build
+```
+
+### 2. Install MCP Server
+
+Run the install script to register with Claude Code:
+
+```powershell
+.\install.ps1
+```
+
+This adds cron-claude to your `~/.claude/config.json` for all sessions.
+
+### 3. Restart Claude Code
+
+Restart Claude Code to load the MCP server.
+
+### 4. Verify Installation
+
+Ask Claude:
+```
+Show me my cron-claude status
+```
+
+Claude will use the `cron_status` tool to verify the installation.
+
+## Quick Start
+
+### Create Your First Task
+
+Just ask Claude naturally:
+
+```
+Create a cron task called "daily-summary" that runs every day at 9 AM.
+The task should check my calendar and create a summary report.
+```
+
+Claude will use the `cron_create_task` tool to create the task file.
+
+### Register with Task Scheduler
+
+```
+Register my daily-summary task with Windows Task Scheduler
+```
+
+Claude will use the `cron_register_task` tool.
+
+### View All Tasks
+
+```
+Show me all my scheduled cron tasks
+```
+
+Claude will use the `cron_list_tasks` tool.
+
+## Available MCP Tools
+
+All tools are automatically available in Claude Code sessions:
+
+### Task Management
+
+- **`cron_create_task`** - Create a new scheduled task
+  - Parameters: task_id, schedule, invocation, instructions, toast_notifications, enabled
+
+- **`cron_register_task`** - Register task with Windows Task Scheduler
+  - Parameters: task_id
+
+- **`cron_unregister_task`** - Remove task from scheduler
+  - Parameters: task_id
+
+- **`cron_enable_task`** - Enable a task
+  - Parameters: task_id
+
+- **`cron_disable_task`** - Disable a task
+  - Parameters: task_id
+
+### Task Execution
+
+- **`cron_run_task`** - Execute a task immediately
+  - Parameters: task_id
+
+- **`cron_list_tasks`** - Show all tasks with status
+  - No parameters
+
+- **`cron_get_task`** - Get full task definition
+  - Parameters: task_id
+
+### Logging & Verification
+
+- **`cron_view_logs`** - View execution logs from memory skill
+  - Parameters: task_id
+
+- **`cron_verify_log`** - Verify log cryptographic signature
+  - Parameters: log_content
+
+### System
+
+- **`cron_status`** - Show system status and configuration
+  - No parameters
+
+## Usage Examples
+
+### Example 1: Create and Schedule a Task
+
+**You:**
+```
+Create a cron task that runs every Monday at 9 AM to generate a weekly report.
+Use the CLI invocation method and enable toast notifications.
+```
+
+**Claude will:**
+1. Use `cron_create_task` to create the task file
+2. Ask you to review the task definition
+3. Use `cron_register_task` to schedule it
+
+### Example 2: Check Task Status
+
+**You:**
+```
+What cron tasks do I have and when will they run next?
+```
+
+**Claude will:**
+1. Use `cron_list_tasks` to show all tasks
+2. Display schedule, status, and next run times
+
+### Example 3: Run a Task Immediately
+
+**You:**
+```
+Run my daily-summary task right now for testing
+```
+
+**Claude will:**
+1. Use `cron_run_task` to execute immediately
+2. Use `cron_view_logs` to show the results
+
+### Example 4: Verify Logs
+
+**You:**
+```
+Verify the integrity of the logs for my backup task
+```
+
+**Claude will:**
+1. Use `cron_view_logs` to retrieve logs
+2. Use `cron_verify_log` to check signatures
+3. Report if logs are authentic and unmodified
+
+## Task Definition Format
+
+Tasks are defined in markdown files with YAML frontmatter:
+
+```markdown
+---
+id: my-task
+schedule: "0 9 * * *"  # Cron expression
+invocation: cli         # 'cli' or 'api'
+notifications:
+  toast: true          # Windows toast notifications
+enabled: true          # Enable/disable task
+---
+
+# Task Instructions
+
+Your instructions for Claude in markdown format.
+```
+
+### Cron Schedule Format
+
+```
+ ┌─── minute (0-59)
+ │ ┌─── hour (0-23)
+ │ │ ┌─── day of month (1-31)
+ │ │ │ ┌─── month (1-12)
+ │ │ │ │ ┌─── day of week (0-6, Sunday=0)
+ * * * * *
+```
+
+**Common Examples:**
+- `0 9 * * *` - Every day at 9 AM
+- `0 */2 * * *` - Every 2 hours
+- `30 8 * * 1-5` - 8:30 AM on weekdays
+- `0 0 * * 0` - Midnight every Sunday
+- `*/15 * * * *` - Every 15 minutes
+
+### Invocation Methods
+
+**CLI Mode (`invocation: cli`)**
+- Uses local `claude-code` command
+- Full Claude environment with all tools
+- Best for complex, interactive tasks
+- Requires Claude CLI installed
+
+**API Mode (`invocation: api`)**
+- Direct Anthropic API calls
+- More reliable for simple tasks
+- Requires `ANTHROPIC_API_KEY` environment variable
+- May incur API costs
+
+## Audit Logging & Security
+
+### Automatic Logging
+
+Every task execution is automatically logged with:
+- ✅ Every action and step taken
+- ✅ All outputs and errors
+- ✅ Timestamps for each operation
+- ✅ HMAC-SHA256 cryptographic signature
+
+Logs are stored via the `odsp-memory` skill in OneDrive for automatic sync and backup.
+
+### Log Verification
+
+Ask Claude to verify any log:
+```
+Verify the logs for task [task-id] haven't been tampered with
+```
+
+Claude will check the HMAC signature to ensure authenticity.
+
+### Secret Key
+
+On first use, cron-claude generates a secret key:
+- Stored in: `~/.cron-claude/config.json`
+- Used for: Signing all log entries
+- Keep secure: Treat like a password
+
+## Architecture
+
+```
+cron-claude/
+├── src/
+│   ├── mcp-server.ts   # MCP server (stdio protocol)
+│   ├── scheduler.ts    # Windows Task Scheduler integration
+│   ├── executor.ts     # Task execution engine
+│   ├── logger.ts       # Audit logging with HMAC signing
+│   ├── notifier.ts     # Toast notifications
+│   ├── config.ts       # Configuration management
+│   └── types.ts        # TypeScript type definitions
+├── tasks/              # Task definition files (*.md)
+├── dist/               # Compiled JavaScript
+├── install.ps1         # MCP server registration script
+└── uninstall.ps1       # MCP server removal script
+```
+
+## Requirements
+
+- **OS:** Windows 10/11 (uses Windows Task Scheduler)
+- **Node.js:** >= 18.0.0
+- **Claude Code:** With MCP support
+- **Claude CLI:** For CLI invocation mode
+- **Anthropic API Key:** For API invocation mode
+- **odsp-memory skill:** For log storage
+
+## Troubleshooting
+
+### MCP Server Not Available
+
+1. Check if registered:
+   ```bash
+   cat ~/.claude/config.json
+   ```
+
+2. Look for `cron-claude` in `mcpServers`
+
+3. Re-run install script:
+   ```powershell
+   .\install.ps1
+   ```
+
+4. Restart Claude Code
+
+### Task Not Executing on Schedule
+
+Ask Claude:
+```
+Check the status of my [task-id] cron task
+```
+
+Claude will:
+1. Check if task is registered
+2. Verify it's enabled
+3. Show next scheduled run time
+
+You can also check Windows Task Scheduler manually:
+- Open Task Scheduler
+- Look for tasks named `CronClaude_[task-id]`
+
+### No Toast Notifications
+
+- Verify `notifications.toast: true` in task file
+- Check Windows notification settings
+- Disable "Focus Assist" temporarily
+
+### Logs Not Appearing
+
+- Verify odsp-memory skill is working:
+  ```bash
+  odsp-memory status
+  ```
+- Check fallback location: `./logs/` directory
+
+## Uninstallation
+
+To remove the MCP server from Claude Code:
+
+```powershell
+.\uninstall.ps1
+```
+
+This removes the MCP server registration but keeps:
+- Task files in `tasks/`
+- Logs in memory skill
+- Config in `~/.cron-claude/`
+
+To completely remove:
+```powershell
+# Remove MCP registration
+.\uninstall.ps1
+
+# Delete task files
+rm -r tasks/
+
+# Delete config
+rm -r ~/.cron-claude/
+```
+
+## Advanced Usage
+
+### Using API Mode
+
+Set your API key:
+```powershell
+$env:ANTHROPIC_API_KEY = "sk-ant-..."
+```
+
+Ask Claude to create tasks with API invocation:
+```
+Create a simple cron task using API mode to check something daily
+```
+
+### Monitoring Multiple Tasks
+
+```
+Show me the status of all my cron tasks and their next run times
+```
+
+### Batch Operations
+
+```
+Disable all my weekly cron tasks temporarily
+```
+
+Claude can operate on multiple tasks using the MCP tools.
+
+## Example Tasks
+
+See the `tasks/` directory for examples:
+- `example-daily-summary.md` - Daily summary report
+- `example-weekly-backup.md` - Weekly backup task
+
+## Contributing
+
+Contributions welcome! This project demonstrates:
+- MCP server implementation
+- Windows Task Scheduler integration
+- Cryptographic log signing
+- Stdio protocol communication
+
+## License
+
+MIT
+
+---
+
+**Built with ❤️ for automating Claude workflows through MCP**

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * CLI interface for cron-claude
+ * Manage scheduled Claude tasks
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG"}