calendar-search

Search macOS Calendar events by keyword with SQLite queries.

5|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/aashari/ai-agent-skills --skill calendar-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: calendar-search
Source: https://github.com/aashari/ai-agent-skills/tree/main/skills/apple-calendar/calendar-search
Command: npx skills add https://github.com/aashari/ai-agent-skills --skill calendar-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you quickly locate calendar events by searching titles, locations, or descriptions, saving time hunting through long agendas.

Core Features & Use Cases

  • Keyword search across all calendars or a specific calendar to find meetings, reminders, and events by title, location, or description.
  • Flexible filters support optional date ranges (from-to) and time constraints to narrow results.
  • Structured output returns event date, start time, title, location, and calendar for easy consumption by agents.

Quick Start

Search your calendar for a keyword, for example find meetings about standup in the next week.

Frequently Asked Questions about calendar-search

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

FAQPage Schema
How do I search calendar events by keyword on macOS?

Search calendar events by keyword by querying the local macOS Calendar database using SQLite to match text in event titles, locations, or descriptions. Results are returned with date, time, title, location, and calendar details.

Can I filter local calendar searches by specific date ranges?

Local calendar searches support optional date ranges and time constraints to narrow keyword matching results. You can filter events across all calendars or target a specific calendar to retrieve relevant meetings within a defined timeframe.

Does this calendar search require access to the macOS Calendar database?

Calendar search requires access to the local macOS Calendar database to execute SQLite queries. It fetches matching events directly from the local storage and formats the results for consumption by agents.

What is the best way to find specific meetings in a busy local calendar?

Find specific meetings by running keyword searches across event titles, locations, and descriptions. This bypasses manual browsing of long agendas by directly querying the local SQLite calendar database for matching entries.

How do I search across all my calendars for events containing a specific keyword?

Search across all calendars by applying a keyword query to the entire local macOS Calendar database. The search scans titles, locations, and descriptions, returning structured event details including start time and location.