AtlatestRenderedmarkdown
Readme

Minder

Scheduled task channel server for Claude Code sessions, built with Sigil.

Minder manages cron-based scheduled tasks and pushes events into a running Claude Code session via the MCP channel protocol.

Installation

sigil app install codeberg:sigil/minder

Configuration

Schedules are defined in minder.yaml:

schedules:
  check-services:
    cron: "*/30 * * * *"
    prompt: "Check service health"
  daily-review:
    cron: "0 9 * * *"
    prompt: "Daily task review"

Schedules can also be managed at runtime via MCP tools — changes are persisted back to minder.yaml.

Running

Minder is designed to be spawned by Claude Code as a channel MCP server:

claude --channels server:minder

Register in .mcp.json:

{
  "mcpServers": {
    "minder": {
      "command": "./build/dev/bin/minder",
      "env": {}
    }
  }
}

MCP Tools

ToolDescription
list-schedulesList all active scheduled tasks
add-scheduleAdd a recurring or one-time scheduled task
remove-scheduleRemove a scheduled task

Cron expressions use 5 fields: minute hour day-of-month month day-of-week.

Building

sigil deps install
sigil build

A C toolchain is required. On Guix: guix shell -m ../sigil/manifest.scm

License

BSD-3-Clause