calendar-free

Scan a local Calendar database to find open time slots within working hours.

5|Updated Feb 28, 2026

Search Tags:#bash #scheduling #calendar #sqlite3 #free-slots #working-hours #calendar-automation

Ready to run

npx skills add https://github.com/aashari/ai-agent-skills --skill calendar-free

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: calendar-free
Source: https://github.com/aashari/ai-agent-skills/tree/main/skills/apple-calendar/calendar-free
Command: npx skills add https://github.com/aashari/ai-agent-skills --skill calendar-free

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This calendar skill helps you quickly identify open time slots to schedule meetings or events by analyzing your calendar data and respecting working hours.

Core Features & Use Cases

Find open time slots within a day or week (default working hours 08:00–18:00) to facilitate scheduling.
Support inputs like "today", "tomorrow", "this week", or a specific date, with optional duration and time-window constraints.
Useful for coordinating meetings, appointments, or personal planning when availability matters.

Quick Start

Find free time slots on tomorrow between 08:00 and 18:00 for a 1-hour meeting.

Frequently Asked Questions about calendar-free

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I find open time slots in my local calendar for scheduling meetings?▼

To find open time slots, this Skill scans a local calendar database and returns available periods within specified working hours. It calculates free time by checking existing events against your desired scheduling parameters.

How do I check free time slots for a specific date and duration?▼

You can check free time slots by providing inputs like "today", "tomorrow", or a specific date, alongside optional duration constraints. The Skill filters your calendar data to return available windows matching that exact duration.

Do I need sqlite3 and python3 to scan my calendar for available times?▼

Yes, you need sqlite3 and python3 support along with Bash to scan your calendar for available times. The Skill relies on these dependencies to query the local Calendar database and compute free slots.

Can I limit calendar availability checks to custom working hours?▼

Yes, you can limit calendar availability checks to custom working hours by applying time-window constraints. The default scheduling window is set between 08:00 and 18:00, but sub-window parameters can be specified.

What is the best way to find free slots across a whole week?▼

The best way to find free slots across a whole week is using the "this week" input parameter. The calendar automation scans the date range and outputs all all available periods within your configured working hours.