read-calendar-events

Read OS calendar events for a specific date via intent calls.

24.6k|2.7k|Updated Mar 31, 2025
One-click install
npx skills add https://github.com/google-ai-edge/gallery --skill read-calendar-events
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: read-calendar-events
Source: https://github.com/google-ai-edge/gallery/tree/main/Android/src/app/src/main/assets/skills/read-calendar-events
Command: npx skills add https://github.com/google-ai-edge/gallery --skill read-calendar-events

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users often ask an AI assistant about their schedule without the assistant knowing the current date or how to resolve relative dates like "tomorrow" or "this Friday". This Skill provides a deterministic procedure to resolve the correct target date and retrieve the user's OS calendar events for that day.

Core Features & Use Cases

  • Date Resolution: Calls the get_current_date_and_time intent first, then explicitly calculates the target date in YYYY-MM-DD format from relative expressions.
  • Calendar Retrieval: Invokes the read_calendar_events intent with the resolved date to fetch the day's events as JSON.
  • Use Case: A user asks "What meetings do I have this Friday?" The assistant gets the current date, computes Friday's date, reads the calendar events, and replies with a clear summary of the schedule.

Quick Start

Ask the assistant what events are on your calendar for tomorrow and let it resolve the date and read your schedule.

Frequently Asked Questions about read-calendar-events

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

FAQPage Schema
How do I read calendar events for a specific date with an AI assistant?

First call the get_current_date_and_time intent to learn today's date, then calculate the target date in YYYY-MM-DD format, and finally call the read_calendar_events intent with that date. The returned JSON list is then summarized for the user.

How to resolve relative dates like tomorrow or this Friday before reading a calendar?

Get the current date and day of the week from the get_current_date_and_time intent, then explicitly compute the requested relative day into an exact YYYY-MM-DD date. Only after this calculation should the calendar read intent be called.

What date format does the calendar events intent require?

The read_calendar_events intent requires the date parameter as a string in YYYY-MM-DD format, passed inside a JSON parameters object. Any relative expression must be converted to this format before the call.

Why does calendar reading return wrong events for relative date requests?

Wrong results usually happen when the target date is guessed instead of calculated from the actual current date and day of the week. Always fetch the current date first and explicitly compute the target date before invoking the read intent.