# Macos Calendar Reminders Skill

> Manage Apple Calendar events and Apple Reminders on macOS via calctl.py and remindctl.py — self-contained EventKit CLI scripts. Use when the user wants to create, query, update, or delete calendar events or reminders on macOS.

- **Type:** Skill
- **Install:** `agentstack add skill-cosmostima-macos-calendar-reminders-skill-macos-calendar-reminders-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Cosmostima](https://agentstack.voostack.com/s/cosmostima)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Cosmostima](https://github.com/Cosmostima)
- **Source:** https://github.com/Cosmostima/macos-calendar-reminders-skill

## Install

```sh
agentstack add skill-cosmostima-macos-calendar-reminders-skill-macos-calendar-reminders-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# macOS Calendar & Reminders

Two CLI tools for **Apple Calendar** (`calctl.py`) and **Apple Reminders** (`remindctl.py`). Dependencies auto-installed by `uv`.

Full reference: [`calctl.md`](references/calctl.md) · [`remindctl.md`](references/remindctl.md) · [`authorization.md`](references/authorization.md)

---

## Routing

| Scenario | Tool |
|----------|------|
| Time blocks (meetings, appointments, events) | calctl — Calendar |
| Tasks / deadlines / todos | remindctl — Reminder |

Use `list` to discover available calendars and reminder lists before creating items.

---

## Quick Reference

```bash
# Calendar
uv run scripts/calctl.py list
uv run scripts/calctl.py get --calendar all --start 2026-03-16 --end 2026-03-22
uv run scripts/calctl.py create --calendar Work --title "Meeting" --start 2026-03-20T14:00:00 --end 2026-03-20T15:00:00
uv run scripts/calctl.py search --query "review"
uv run scripts/calctl.py update --id "" --start 2026-03-20T15:00:00 --end 2026-03-20T16:00:00
uv run scripts/calctl.py delete --calendar Work --id ""

# Reminders
uv run scripts/remindctl.py list
uv run scripts/remindctl.py get today
uv run scripts/remindctl.py get week --list Work
uv run scripts/remindctl.py create --title "Submit report" --list Work --due 2026-03-20T23:59:00 --priority high
uv run scripts/remindctl.py search --query "assignment"
uv run scripts/remindctl.py update --id "" --due 2026-03-21T23:59:00
uv run scripts/remindctl.py complete --id ""
uv run scripts/remindctl.py delete --id "" --confirm
```

---

## Authorization

On first use, run `status --authorize` to trigger the macOS permission prompt:

```bash
uv run scripts/calctl.py status --authorize
uv run scripts/remindctl.py status --authorize
```

If permission is denied or the prompt doesn't appear, read [`authorization.md`](references/authorization.md) to guide the user through manual setup. Do **not** retry in a loop.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Cosmostima](https://github.com/Cosmostima)
- **Source:** [Cosmostima/macos-calendar-reminders-skill](https://github.com/Cosmostima/macos-calendar-reminders-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-cosmostima-macos-calendar-reminders-skill-macos-calendar-reminders-skill
- Seller: https://agentstack.voostack.com/s/cosmostima
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
