google-calendar

| Default Behavior | Show Only |

| :-------------------- | :--------------------------------- |

| Standard schedule | Accepted and pending (needsAction) |

| "Show all meetings" | Include declined |

| "What did I decline?" | Filter to declined only |

This respects the user's time by not cluttering their schedule with irrelevant

meetings.

Creating Events

Use calendar.createEvent to add new events. **Always preview the event before

creating it and wait for user confirmation.**

### Preview Format

I'll create this event:

📅 Title: Weekly Standup
📆 Date: January 15, 2025
🕐 Time: 10:00 AM - 10:30 AM (EST)
👥 Attendees: alice@example.com, bob@example.com
📝 Description: Weekly team sync
🎥 Google Meet: Will be generated
📎 Attachments: Q1 Agenda (Google Doc)

Should I create this event?

### Key Parameters

• **calendarId** — **Always pass "primary"**. Use calendar.list to

discover other calendars when needed.

• **start / end** — Two formats:
• **Timed events**: { dateTime: "2025-01-15T10:00:00-05:00" } — ISO 8601

with timezone offset

• **All-day events**: { date: "2025-01-15" } — YYYY-MM-DD format. The end

date is exclusive (use the next day).

• **attendees** — Array of email addresses
• **addGoogleMeet** — Set to true to automatically generate a Google Meet

link (available in response's hangoutLink field)

• **attachments** — Array of Google Drive file attachments (fileUrl, title,

optional mimeType). Providing attachments fully replaces any existing

attachments.

• **sendUpdates** — Controls email notifications:
• "all" — Notify all attendees (default when attendees are provided)
• "externalOnly" — Only notify non-organization attendees
• "none" — No notifications
• **eventType** — The type of event (see

Calendar Status Events (#calendar-status-events) below):

• "default" — Regular event (default if omitted)
• "focusTime" — Focus time block
• "outOfOffice" — Out-of-office event
• "workingLocation" — Working location indicator

### Example — Regular Timed Event

calendar.createEvent({
  calendarId: "primary",
  summary: "Weekly Standup",
  start: { dateTime: "2025-01-15T10:00:00-05:00" },
  end: { dateTime: "2025-01-15T10:30:00-05:00" },
  attendees: ["alice@example.com", "bob@example.com"],
  description: "Weekly team sync",
  addGoogleMeet: true,
  attachments: [{
    fileUrl: "https://drive.google.com/file/d/abc123/edit",
    title: "Q1 Agenda",
    mimeType: "application/vnd.google-apps.document"
  }],
  sendUpdates: "all"
})

### Example — All-Day Event

calendar.createEvent({
  calendarId: "primary",
  summary: "Team Offsite",
  start: { date: "2025-01-15" },
  end: { date: "2025-01-17" },
  description: "Two-day team offsite"
})

Calendar Status Events

calendar.createEvent supports creating focus time, out-of-office, and working

location events via the eventType parameter. These are all created through the

same tool — there are no separate tools for each type.

### Focus Time

Blocks concentrated work periods. Can auto-decline conflicting meetings.

> **Constraint:** Focus time events **cannot be all-day events** — they must use

> dateTime, not date.

calendar.createEvent({
  calendarId: "primary",
  eventType: "focusTime",
  start: { dateTime: "2025-01-15T09:00:00-05:00" },
  end: { dateTime: "2025-01-15T12:00:00-05:00" },
  focusTimeProperties: {
    chatStatus: "doNotDisturb",
    autoDeclineMode: "declineOnlyNewConflictingInvitations",
    declineMessage: "In focus mode, will respond later"
  }
})

• **summary** defaults to "Focus Time" if omitted
• **focusTimeProperties.chatStatus** — "doNotDisturb" (default) or

"available"

• **focusTimeProperties.autoDeclineMode** —

"declineOnlyNewConflictingInvitations" (default),

"declineAllConflictingInvitations", or "declineNone"

• **focusTimeProperties.declineMessage** — optional message sent when

declining

### Out of Office

Signals unavailability and auto-declines conflicting meetings.

> **Constraint:** Out-of-office events **cannot be all-day events** — they must

> use dateTime, not date.

calendar.createEvent({
  calendarId: "primary",
  eventType: "outOfOffice",
  summary: "Vacation",
  start: { dateTime: "2025-01-15T00:00:00-05:00" },
  end: { dateTime: "2025-01-19T00:00:00-05:00" },
  outOfOfficeProperties: {
    autoDeclineMode: "declineAllConflictingInvitations",
    declineMessage: "I am on vacation until Jan 19"
  }
})

• **summary** defaults to "Out of Office" if omitted
• **outOfOfficeProperties.autoDeclineMode** —

"declineOnlyNewConflictingInvitations" (default),

"declineAllConflictingInvitations", or "declineNone"

• **outOfOfficeProperties.declineMessage** — optional message sent when

declining

### Working Location

Indicates where the user is working from. Supports both timed and all-day

events.

calendar.createEvent({
  calendarId: "primary",
  eventType: "workingLocation",
  start: { date: "2025-01-15" },
  end: { date: "2025-01-16" },
  workingLocationProperties: {
    type: "homeOffice"
  }
})

• **summary** defaults to "Working Location" if omitted
• **All-day working location events** must span **exactly one day**. Use the

next day as the exclusive end date.

• **workingLocationProperties** is **required** when eventType is

"workingLocation"

• **workingLocationProperties.type** — "homeOffice", `"officeLocat