mygopher-calendar

Retrieve Google Calendar events using existing OAuth refresh tokens.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/StevenMih/amicable --skill mygopher-calendar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mygopher-calendar
Source: https://github.com/StevenMih/amicable/tree/main/deploy/mygopher/skills/mygopher-calendar
Command: npx skills add https://github.com/StevenMih/amicable --skill mygopher-calendar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows users to access and query their Google Calendar events without needing to grant new permissions, leveraging existing OAuth credentials.

Core Features & Use Cases

  • List upcoming events: View events from the primary calendar.
  • Search by date range: Filter events within specific timeframes.
  • Read event details: Access titles, descriptions, attendees, and times.
  • Find free/busy windows: Identify available slots for scheduling.
  • Enumerate calendars: List all accessible calendars.
  • Use Case: Ask "What are my meetings tomorrow?" or "When am I free next Tuesday afternoon?".

Quick Start

Use the mygopher-calendar skill to list upcoming events for the next 30 days.

Frequently Asked Questions about mygopher-calendar

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

FAQPage Schema
How do I retrieve Google Calendar events using existing OAuth refresh tokens?

To retrieve Google Calendar events, the Skill uses existing OAuth refresh tokens with the calendar.readonly scope to fetch and display upcoming events without requiring new permission grants.

Do I need a GCP project to query Google Calendar events?

Yes, querying Google Calendar events requires GCP OAuth credentials, specifically the GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET, and GMAIL_REFRESH_TOKEN environment variables configured for token acquisition.

Can I search Google Calendar events by a specific date range?

Searching Google Calendar events by specific date range is fully supported, allowing you to filter and read event details like titles, descriptions, and attendees within defined timeframes.

How do I find free and busy slots in Google Calendar for scheduling?

Finding free and busy slots in Google Calendar involves querying your accessible calendars to identify available time windows, helping you determine when you are free for scheduling.

What are the limitations of accessing Google Calendar with a readonly OAuth scope?

A readonly OAuth scope limits actions to retrieving and querying Google Calendar data, meaning you cannot create, modify, or delete events, only list upcoming events and enumerate calendars.

Can I list all accessible Google Calendars or only the primary calendar?

Enumerating all accessible Google Calendars is supported, enabling you to list every available calendar alongside viewing upcoming events from your primary calendar.