id: google-workspace/google-calendar
slug: google-calendar-for-ai-agents-search-before-you-create
title: "Google Calendar For AI Agents: Search Before You Create"
description: "A portable Google Calendar skill for AI agents: choose scope
  first, search before creating events, use exact IDs for mutations, and treat
  recurrence as high risk."
public_url: https://build-os.com/agent-skills/google-calendar-for-ai-agents-search-before-you-create
raw_skill_url: https://build-os.com/agent-skills/google-calendar-for-ai-agents-search-before-you-create/skill.md
portable_skill_url: https://build-os.com/agent-skills/google-calendar-for-ai-agents-search-before-you-create/portable/SKILL.md
bundle_url: https://build-os.com/agent-skills/google-calendar-for-ai-agents-search-before-you-create/bundle.zip
runtime_skill_id: google_calendar
skill_type: provider
skill_category: google-workspace
providers:
  - Google Calendar
  - Google Workspace
compatible_agents:
  - BuildOS-compatible agents
  - Claude Code
  - Codex
  - portable Agent Skills
stack_with:
  - OAuth 2.0 for agents
  - Gmail for agents
  - Founder assistant stack
lineage_profiles: []
lineage_sources:
  - title: Google Calendar API Events resource
    creator: Google Workspace
    creatorType: Organization
    url: https://developers.google.com/workspace/calendar/api/v3/reference/events
    sourceType: official_docs
  - title: Google Calendar events.list
    creator: Google Workspace
    creatorType: Organization
    url: https://developers.google.com/workspace/calendar/api/v3/reference/events/list
    sourceType: official_docs
  - title: Google Calendar events.insert
    creator: Google Workspace
    creatorType: Organization
    url: https://developers.google.com/workspace/calendar/api/v3/reference/events/insert
    sourceType: official_docs
  - title: Google Calendar events.patch
    creator: Google Workspace
    creatorType: Organization
    url: https://developers.google.com/workspace/calendar/api/v3/reference/events/patch
    sourceType: official_docs
  - title: Google Calendar recurring events guide
    creator: Google Workspace
    creatorType: Organization
    url: https://developers.google.com/workspace/calendar/api/guides/recurringevents
    sourceType: official_docs
  - title: Google Calendar extended properties guide
    creator: Google Workspace
    creatorType: Organization
    url: https://developers.google.com/workspace/calendar/api/guides/extended-properties
    sourceType: official_docs
  - title: Google Calendar push notifications guide
    creator: Google Workspace
    creatorType: Organization
    url: https://developers.google.com/workspace/calendar/api/guides/push
    sourceType: official_docs
  - title: Google Calendar free/busy query
    creator: Google Workspace
    creatorType: Organization
    url: https://developers.google.com/workspace/calendar/api/v3/reference/freebusy/query
    sourceType: official_docs
lineage_stats:
  sources: 8
  primitives: 7
  sourceClaims: 8
  edges: 14
  referenceModules: 1
gallery:
  display_title: "Google Calendar For AI Agents: Search Before You Create"
  family: Connected Tools
  domain_id: google-workspace
  output_shapes:
    - safe action plan
    - event mutation checklist
  workflow:
    - Choose the calendar scope.
    - Search before creating or changing events.
    - Use exact event IDs for mutations.
    - Treat recurrence and time zones as high-risk.
  use_cases:
    - Prevent duplicate calendar event creation.
    - Update events with exact IDs and scope.
    - Handle recurring events with appropriate caution.
  guardrails: &a1
    - Do not create events before searching.
    - Do not mutate recurring events casually.
    - Do not guess event IDs.
  starter_prompts:
    - Help me safely create a calendar event without duplicating anything.
    - Audit this calendar update plan for recurrence, time zone, and exact-ID
      risk.
  source:
    curated: true
    runtime: true
    blog: true
    fallback: false
  trust:
    eval_status: not-covered
    last_updated: 2026-04-27
    safety_notes: *a1
references:
  - id: google_calendar.public_safe_write_rules
    path: references/public-safe-write-rules.md
    summary: Portable checklist for scope, lookup, create/update/delete, recurrence,
      time zones, and sync boundaries.
    when_to_load:
      - When using the portable bundle outside BuildOS.
      - Before creating, updating, deleting, or rescheduling calendar events.
      - When recurrence, attendee notification, duplicate event, or sync risk is
        present.
