Google Calendar Integration

Integration with Google Calendar via Apps Script Web API for checking schedules and managing events.

When to Use

Use this skill when the user wants to:

• Check their schedule or calendar
• View today's events and meetings
• See weekly calendar overview
• Find upcoming events in the next few hours
• Create new calendar events
• Add meeting invites with guests

Do NOT use this skill if:

• The user wants to modify existing events → use Google Calendar directly instead
• The user needs calendar setup → follow

  ./SETUP.md

  first
• The user needs other calendar providers (Outlook, etc.)

Typical triggers:

• 「查看日历」「今天有什么安排」「我的日程」
• 「check my calendar」「what's on my schedule"
• 「add meeting」「create event」「schedule a call"
• 「这周有什么会议」「upcoming events"

Workflow

Step 1: Verify Setup

Ensure the user has completed the setup:

• Google Apps Script deployed as web app
• API URL and token configured
• Calendar access permissions granted

If not set up, guide them through

./SETUP.md

Step 2: Gather Query Requirements

Determine what the user needs:

• Today's events: Quick daily overview
• This week: Weekly calendar view
• Upcoming: Next N hours (default: 4 hours)
• Date range: Specific start/end dates
• Create event: New meeting with title, time, guests

Step 3: Execute Calendar Action

Use the appropriate API endpoint:

today

week

upcoming

hours

range

start

end

create

title

start

end

guests

description

location

Step 4: Present Results

Return events in a clear, readable format:

• Event title and time
• Location (if any)
• All-day event indicator

Guardrails

• Always verify API token is configured before making requests
• Handle expired/invalid tokens gracefully
• Respect user privacy - don't share calendar data with unauthorized parties
• When creating events, confirm details with user before execution
• Guest emails must be valid - invalid emails will fail silently

API Response Format

{
  "count": 1,
  "events": [
    {
      "title": "Meeting Name",
      "start": "2026-01-04T09:00:00.000Z",
      "end": "2026-01-04T10:00:00.000Z",
      "location": "Zoom link or address",
      "isAllDay": false
    }
  ]
}

Related Skills

• meeting-scheduler — For complex scheduling with multiple participants
• zoom-meeting — For generating meeting links to include in calendar events

References

• SETUP.md

  — Setup instructions for Google Apps Script

• references/calendar-api.gs

  — The Apps Script implementation

• references/clasp-setup.md

  — Detailed clasp CLI guide

About UniqueClub

Part of the UniqueClub toolkit. 🌐 https://uniqueclub.ai 📂 https://github.com/wulaosiji/skills