Calendar Create Event
When to Use
- User asks to "create an event" or "schedule a meeting"
- User asks to "add to calendar" or "set up a call"
- User wants to "book time" or "schedule something"
- User asks to make an event recurring
Tools
Discovery
- GOOGLECALENDAR_CUSTOM_LIST_CALENDARS — List all calendars
- GOOGLECALENDAR_FIND_FREE_SLOTS — Find available time slots
- GOOGLECALENDAR_FREE_BUSY_QUERY — Check busy/free status
- GOOGLECALENDAR_CUSTOM_FETCH_EVENTS — List events in time range
- GOOGLECALENDAR_CUSTOM_FIND_EVENT — Search events by keyword
Creation & Modification (Custom Tools vs Standard Tools)
Prefer using Custom Tools over standard Composio tools where possible, as they are simplified and sufficient for most use cases. However, standard tools (like GOOGLECALENDAR_CREATE_EVENT) are fully featured and can be used when advanced functionality is missing.
- GOOGLECALENDAR_CUSTOM_CREATE_EVENT — Create new event
confirm_immediately: False (default, sends to frontend for review)
- GOOGLECALENDAR_CREATE_EVENT — Standard composer tool. Use if the custom tool doesn't support an advanced parameter you explicitly need.
- GOOGLECALENDAR_CUSTOM_ADD_RECURRENCE — Add recurrence to existing event
- frequency: DAILY, WEEKLY, MONTHLY, YEARLY
- by_day: ["MO", "WE", "FR"] etc.
- count / until: Limit occurrences
- GOOGLECALENDAR_CUSTOM_PATCH_EVENT — Modify event
- GOOGLECALENDAR_CUSTOM_DELETE_EVENT — Delete (REQUIRES CONSENT)
Workflow
Step 1: Identify the Right Calendar
GOOGLECALENDAR_CUSTOM_LIST_CALENDARS()
- User may have multiple calendars (Work, Personal, Shared)
- If ambiguous, ask: "Which calendar? You have Work and Personal."
- Default to primary calendar if only one exists
Step 2: Gain Context & Check Availability (CRITICAL for meetings)
When scheduling with attendees or specific times, always understand the user's day first.
- Get the Day's Context:
GOOGLECALENDAR_CUSTOM_GET_DAY_SUMMARY(
date="2026-03-01"
)
- Or use
GOOGLECALENDAR_CUSTOM_FETCH_EVENTS for a wider range.
- Use this to understand what else the user has going on that day so you don't schedule a heavy meeting right after another heavy meeting or during their focus time.
- Find Free Slots (if needed):
GOOGLECALENDAR_FIND_FREE_SLOTS(
calendar_id="primary",
time_min="2026-03-01T09:00:00",
time_max="2026-03-01T17:00:00"
)
- Show available slots to user
- If attendee calendars are accessible, check their availability too
- Suggest the first available slot that works
- If all-day event, skip availability check
Step 3: Handle Timezone
All times in user's local timezone. The backend handles conversion.
- Use ISO format:
"2026-03-01T10:00:00"
- Do NOT include timezone offset in datetime strings
- Respect the user's stated time literally (if they say "3pm", use 15:00)
Step 4: Create the Event
GOOGLECALENDAR_CUSTOM_CREATE_EVENT(
calendar_id="primary",
title="Team Standup",
start_time="2026-03-01T09:00:00",
end_time="2026-03-01T09:30:00",
description="Daily sync",
attendees=["alice@company.com", "bob@company.com"],
create_meeting_room=True,
confirm_immediately=False
)
Confirmation workflow:
- Default:
confirm_immediately=False → Event sent to frontend for user review
- Only use
confirm_immediately=True when user explicitly says "just create it" or when confirming a previously drafted event
Always set create_meeting_room=True when:
- The event has attendees (i.e., it's a meeting)
- The event is described as "online", "virtual", or a "call"
- The user explicitly asks for a meeting link
This automatically generates a Google Meet link. It never hurts to add one for a meeting! Only omit if the user explicitly says they don't want a video call.
Step 5: Add Recurrence (2-step process)
Recurrence CANNOT be set during creation. Always create first, then add:
GOOGLECALENDAR_CUSTOM_ADD_RECURRENCE(
event_id="created_event_id",
calendar_id="primary",
frequency="WEEKLY",
by_day=["MO", "WE", "FR"],
count=10
)
Common patterns:
- Daily standup:
frequency="WEEKLY", by_day=["MO","TU","WE","TH","FR"]
- Weekly 1:1:
frequency="WEEKLY"
- Monthly review:
frequency="MONTHLY"
- Until date:
until="2026-06-30T00:00:00"
- N occurrences:
count=10
Step 6: Confirm to User
Report:
- Event title and time
- Calendar it was added to
- Attendees (if any)
- Recurrence pattern (if set)
- "Check your calendar to confirm the details."
Error Recovery
If creation fails:
- Calendar not found → LIST_CALENDARS → verify correct calendar_id → retry
- Time conflict → FIND_FREE_SLOTS → suggest alternative time → retry
- Permission error → Inform user, suggest checking calendar sharing settings
Important Rules
- Check availability first — Especially for meetings with attendees
- Local timezone always — Don't convert to UTC, backend handles it
- Confirm before finalizing — Use confirm_immediately=False by default
- Recurrence is 2-step — Create event first, then add recurrence
- Delete requires consent — Never delete events without asking
1---2name: calendar-create-event3description: Create calendar events intelligently - check availability, handle attendees, manage recurrence, timezone-aware scheduling with confirmation workflow.4target: googlecalendar_agent5metadata:6 source: https://skillmd.com/skills/theexperiencecompany/calendar-create-event7---89# Calendar Create Event1011## When to Use12- User asks to "create an event" or "schedule a meeting"13- User asks to "add to calendar" or "set up a call"14- User wants to "book time" or "schedule something"15- User asks to make an event recurring1617## Tools1819### Discovery20- **GOOGLECALENDAR_CUSTOM_LIST_CALENDARS** — List all calendars21- **GOOGLECALENDAR_FIND_FREE_SLOTS** — Find available time slots22- **GOOGLECALENDAR_FREE_BUSY_QUERY** — Check busy/free status23- **GOOGLECALENDAR_CUSTOM_FETCH_EVENTS** — List events in time range24- **GOOGLECALENDAR_CUSTOM_FIND_EVENT** — Search events by keyword2526### Creation & Modification (Custom Tools vs Standard Tools)27> **Prefer using Custom Tools** over standard Composio tools where possible, as they are simplified and sufficient for most use cases. However, standard tools (like `GOOGLECALENDAR_CREATE_EVENT`) are fully featured and can be used when advanced functionality is missing.2829- **GOOGLECALENDAR_CUSTOM_CREATE_EVENT** — Create new event30 - `confirm_immediately`: False (default, sends to frontend for review)31- **GOOGLECALENDAR_CREATE_EVENT** — Standard composer tool. Use if the custom tool doesn't support an advanced parameter you explicitly need.32- **GOOGLECALENDAR_CUSTOM_ADD_RECURRENCE** — Add recurrence to existing event33 - frequency: DAILY, WEEKLY, MONTHLY, YEARLY34 - by_day: ["MO", "WE", "FR"] etc.35 - count / until: Limit occurrences36- **GOOGLECALENDAR_CUSTOM_PATCH_EVENT** — Modify event37- **GOOGLECALENDAR_CUSTOM_DELETE_EVENT** — Delete (REQUIRES CONSENT)3839## Workflow4041### Step 1: Identify the Right Calendar4243```44GOOGLECALENDAR_CUSTOM_LIST_CALENDARS()45```4647- User may have multiple calendars (Work, Personal, Shared)48- If ambiguous, ask: "Which calendar? You have Work and Personal."49- Default to primary calendar if only one exists5051### Step 2: Gain Context & Check Availability (CRITICAL for meetings)5253When scheduling with attendees or specific times, **always understand the user's day first**.54551. **Get the Day's Context:**56```57GOOGLECALENDAR_CUSTOM_GET_DAY_SUMMARY(58 date="2026-03-01"59)60```61- Or use `GOOGLECALENDAR_CUSTOM_FETCH_EVENTS` for a wider range.62- Use this to understand what else the user has going on that day so you don't schedule a heavy meeting right after another heavy meeting or during their focus time.63642. **Find Free Slots (if needed):**65```66GOOGLECALENDAR_FIND_FREE_SLOTS(67 calendar_id="primary",68 time_min="2026-03-01T09:00:00",69 time_max="2026-03-01T17:00:00"70)71```7273- Show available slots to user74- If attendee calendars are accessible, check their availability too75- Suggest the first available slot that works76- If all-day event, skip availability check7778### Step 3: Handle Timezone7980**All times in user's local timezone.** The backend handles conversion.8182- Use ISO format: `"2026-03-01T10:00:00"`83- Do NOT include timezone offset in datetime strings84- Respect the user's stated time literally (if they say "3pm", use 15:00)8586### Step 4: Create the Event8788```89GOOGLECALENDAR_CUSTOM_CREATE_EVENT(90 calendar_id="primary",91 title="Team Standup",92 start_time="2026-03-01T09:00:00",93 end_time="2026-03-01T09:30:00",94 description="Daily sync",95 attendees=["alice@company.com", "bob@company.com"],96 create_meeting_room=True,97 confirm_immediately=False98)99```100101**Confirmation workflow:**102- Default: `confirm_immediately=False` → Event sent to frontend for user review103- Only use `confirm_immediately=True` when user explicitly says "just create it" or when confirming a previously drafted event104105> Always set `create_meeting_room=True` when:106> - The event has attendees (i.e., it's a meeting)107> - The event is described as "online", "virtual", or a "call"108> - The user explicitly asks for a meeting link109> This automatically generates a Google Meet link. It never hurts to add one for a meeting! Only omit if the user explicitly says they don't want a video call.110111### Step 5: Add Recurrence (2-step process)112113Recurrence CANNOT be set during creation. Always create first, then add:114115```116GOOGLECALENDAR_CUSTOM_ADD_RECURRENCE(117 event_id="created_event_id",118 calendar_id="primary",119 frequency="WEEKLY",120 by_day=["MO", "WE", "FR"],121 count=10122)123```124125**Common patterns:**126- Daily standup: `frequency="WEEKLY", by_day=["MO","TU","WE","TH","FR"]`127- Weekly 1:1: `frequency="WEEKLY"`128- Monthly review: `frequency="MONTHLY"`129- Until date: `until="2026-06-30T00:00:00"`130- N occurrences: `count=10`131132### Step 6: Confirm to User133134Report:135- Event title and time136- Calendar it was added to137- Attendees (if any)138- Recurrence pattern (if set)139- "Check your calendar to confirm the details."140141## Error Recovery142143If creation fails:1441. **Calendar not found** → LIST_CALENDARS → verify correct calendar_id → retry1452. **Time conflict** → FIND_FREE_SLOTS → suggest alternative time → retry1463. **Permission error** → Inform user, suggest checking calendar sharing settings147148## Important Rules1491. **Check availability first** — Especially for meetings with attendees1502. **Local timezone always** — Don't convert to UTC, backend handles it1513. **Confirm before finalizing** — Use confirm_immediately=False by default1524. **Recurrence is 2-step** — Create event first, then add recurrence1535. **Delete requires consent** — Never delete events without asking