google-calendar

Find scheduled events and free time blocks in Google Calendar.

Updated May 6, 2026
One-click install
npx skills add https://github.com/Uniquecrete/ThinkFasterv1 --skill google-calendar-uniquecrete
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-calendar
Source: https://github.com/Uniquecrete/ThinkFasterv1/tree/main/Skills/google-calendar
Command: npx skills add https://github.com/Uniquecrete/ThinkFasterv1 --skill google-calendar-uniquecrete

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you quickly understand what’s scheduled in your Google Calendar and identify available time blocks without manually checking each event.

Core Features & Use Cases

  • Event lookup by day: Lists events for a specified date (including natural-language dates like today, tomorrow, or next Monday).
  • Free-time block detection: Finds gaps between events within configurable working hours and minimum duration.
  • Week overview: Summarizes the current week’s schedule and highlights what’s happening each day.
  • Machine-readable output: Produces JSON event data for programmatic or agent workflows.
  • Use Case: You need a 1-hour meeting slot on Friday between 10am and 4pm; use the free-time block finder to return candidate openings.

Quick Start

Ask: what’s on my calendar today?

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 blocks in Google Calendar?

This Skill finds free time blocks in Google Calendar by detecting gaps between scheduled events within configurable working hours and minimum duration constraints. It returns candidate openings for meetings or tasks.

Can I use natural language to look up my Google Calendar schedule?

You can look up your Google Calendar schedule using natural-language dates like today, tomorrow, or next Monday. The Skill parses these queries to list events and provide a week overview.

Do I need OAuth tokens to query Google Calendar events?

You need direct Google OAuth tokens to query Google Calendar events. This Skill requires the google-direct-oauth skill for authentication to access your schedule and return JSON event data.

How do I export Google Calendar events to JSON?

To export Google Calendar events to JSON, query your schedule for a specific date or week. This Skill produces machine-readable JSON event data suitable for programmatic workflows and agent integrations.

What is the best way to get a Google Calendar week overview?

The best way to get a Google Calendar week overview is to request a weekly summary from this Skill. It highlights daily events and identifies available free blocks across the current week.

Does this Skill work without manually checking each Google Calendar event?

This Skill works without manually checking each Google Calendar event by automatically listing scheduled items and detecting free time gaps. It uses gcal.py CLI logic to process events and return JSON output.