google-calendar

Find scheduled events and free time blocks in Google Calendar via API.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/ankitjh4/skill-builder --skill google-calendar-ankitjh4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-calendar
Source: https://github.com/ankitjh4/skill-builder/tree/main/google-calendar
Command: npx skills add https://github.com/ankitjh4/skill-builder --skill google-calendar-ankitjh4

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you quickly understand what is on your Google Calendar and identify available free time blocks, without manually scanning events.

Core Features & Use Cases

  • Event lookup: Lists scheduled events for a given day (including “today,” “tomorrow,” and relative weekday phrases).
  • Free-time discovery: Computes open blocks within configurable working hours and a minimum duration threshold.
  • Weekly overview: Summarizes events across the current week and marks which day is today.
  • Use case: If you need to schedule a meeting, you can ask for free time on a specific day and window (e.g., “free Friday between 10am and 4pm” with a minimum length), then pick an available slot.

Quick Start

Ask: show my events today and then find free time tomorrow.

Frequently Asked Questions about google-calendar

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

FAQPage Schema
How do I find free time slots in Google Calendar for meeting scheduling?

To find free time slots for meeting scheduling, this Skill computes open blocks in Google Calendar by checking your scheduled events against configurable working hours and a minimum duration threshold. You simply request free time for a specific date and time window.

Can I list my Google Calendar events for a specific day using a command line tool?

Yes, you can list Google Calendar events for a specific day using this Python CLI. It supports daily event listings and recognizes relative phrases like “today,” “tomorrow,” and weekdays to show your scheduled meetings without manual calendar scanning.

Do I need OAuth to view Google Calendar events and available time blocks?

Yes, you need a working Google Direct OAuth connection with valid tokens to view Google Calendar events and available time blocks. This Skill requires authenticated OAuth credentials to securely call the Google Calendar API and compute gaps between busy events.

How does the weekly overview feature summarize calendar events?

The weekly overview feature summarizes calendar events by listing all scheduled items across the current week and explicitly marks which day is today. It provides a quick snapshot of your weekly time planning without requiring you to manually check each day.

What is the best way to check calendar availability within specific working hours?

The best way to check calendar availability within specific working hours is to request free time constrained by your schedule. This Skill calculates open meeting slots by filtering out busy events and applying your defined working hours and minimum block duration.

Why does the free time search require a minimum block duration?

The free time search requires a minimum block duration to ensure the available time slots are actually useful for meeting scheduling. It filters out brief gaps between events that are too short to hold a meaningful appointment.