calcurse

What This Skill Does

The calcurse skill provides the OpenClaw agent with the ability to manage personal schedules and todo lists directly from the command line interface. Designed for efficiency, this tool leverages the powerful calcurse terminal-based calendar application to perform rapid appointments, task management, and event queries. It serves as a lightweight alternative to graphical calendar suites, making it perfect for users who prefer text-centric workflows.

Installation

To install the calcurse skill within your OpenClaw environment, ensure you have the calcurse package installed on your host system. Then, execute the following command in your terminal:

clawhub install openclaw/skills/skills/gumadeiras/calcurse

Use Cases

• Streamlined Scheduling: Quickly add meetings or reminders to your calendar without leaving your terminal or IDE.
• Deadline Tracking: Maintain a organized todo list with specific priorities to ensure your project milestones stay on track.
• Quick Lookups: Instantly query your upcoming agenda for the next few days to stay prepared for meetings.
• Automation: Integrate scheduling into custom scripts or agent workflows, allowing the agent to manage your calendar autonomously.

Example Prompts

1. "OpenClaw, please add a team sync meeting to my calendar for January 21st, 2026, at 2 PM, lasting for 60 minutes."
2. "Can you check my schedule for the next two days and summarize any upcoming appointments?"
3. "Add a high-priority todo item for me: 'Finish technical documentation' and set its priority level to 1."

Tips & Limitations

• Interactive Mode: While the non-interactive CLI mode is excellent for quick tasks, running calcurse in a PTY session provides a much richer interactive experience. If you need to perform bulk editing or organize complex events, use an interactive session.
• Data Integrity: Since the skill interacts directly with the local calcurse data files, ensure your environment variables are correctly configured to point to your standard data directory.
• Precision: When adding items, ensure the date format adheres to YYYY-MM-DD standards, and double-check your duration inputs in minutes to prevent scheduling overlaps. Note that the skill currently lacks native integration with external cloud calendar APIs (like Google Calendar) and is strictly a local tool.