search-calendar

Searches Google Calendar by day, date, week, subject, attendee, or email with AND filters.

Updated Oct 21, 2025
One-click install
npx skills add https://github.com/christopheryeo/claude-skills --skill search-calendar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: search-calendar
Source: https://github.com/christopheryeo/claude-skills/tree/main/search-calendar
Command: npx skills add https://github.com/christopheryeo/claude-skills --skill search-calendar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Claude users often need to locate calendar events across multiple calendars without writing complex queries. This skill enables natural-language calendar searching and precise retrieval from Google Calendar data, reducing manual sifting and improving briefing quality.

Core Features & Use Cases

  • Multi-dimensional search: query by day, date, week, subject, attendees, and emails, using AND-style filtering to narrow results.
  • Event enrichment for briefings: return explicit Asia/Singapore times, duration in minutes, attendee context, location, description, and conference links.
  • Timeline-oriented results: cap at 50 events and sort chronologically for easy briefing integration.

Quick Start

Place the search-calendar folder under Claude's skills directory, enable the skill, and ask natural language questions such as "What meetings do I have with Eddie next week?" or "Show me events with Mani today."

Frequently Asked Questions about search-calendar

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

FAQPage Schema
How do I search Google Calendar using natural language queries?

You can search Google Calendar using natural language by specifying criteria like day, date, week, subject, attendees, or emails. The skill processes these conversational queries with AND logic to filter and retrieve matching events.

Can I find specific calendar events by attendee name and date range?

Yes, you can find calendar events by combining attendee names or emails with specific dates, weeks, or days. The skill applies AND-style filtering across these dimensions to narrow down and retrieve precise event results.

How does timezone normalization work for Google Calendar search results?

Timezone normalization converts event times to Asia/Singapore. The skill enriches Google Calendar search results with explicit localized times, duration in minutes, attendee context, locations, descriptions, and conference links.

What is the maximum number of events returned when searching Google Calendar?

The maximum number of events returned is 50 non-cancelled events. The skill filters out cancelled events and sorts the remaining results chronologically to ensure timeline-oriented output for easy briefing integration.

How do I get meeting briefings with duration and conferencing data from Google Calendar?

To get meeting briefings, the skill retrieves Google Calendar events and enriches them with duration in minutes, attendee context, and conferencing data. It returns chronological results capped at 50 events for briefing preparation.

Are there limitations when filtering Google Calendar events across multiple calendars?

A key limitation is the 50-event maximum cap on search results. Additionally, timezone normalization is fixed to Asia/Singapore, and cancelled events are automatically excluded from the filtered, chronologically sorted output.