grr

Overview Schema Source Related Servers Discussions Admin

calendar.events.move

Move a default calendar event to another calendar by changing its organizer; transfer events between calendars with optional guest notifications.

Instructions

Moves an event to another calendar, i.e. changes an event's organizer. Note that only default events can be moved; birthday, focusTime, fromGmail, outOfOffice and workingLocation events cannot be moved [HTTP POST] — creates or triggers a change; refused under --readonly safety profiles. Returns the API's response resource as JSON — request bodies are built from the typed parameters (typed flags win over the params map), or read whole from body_file Siblings over the same resource: delete, get, import, insert, instances, list, patch, quickAdd, update, watch.

Input Schema

Name	Required	Description
`query`	No	Extra KEY=VALUE query pairs for endpoints whose parameters Discovery does not describe.
`params`	No	Parameter map merged into the request; typed parameters win.
`dry_run`	No	Return the request that would be sent, without sending it.
`eventId`	Yes	[URL path segment] Event identifier.
`body_file`	No	Read the request body from this file ('-' for stdin) instead of building one from the parameters.
`calendarId`	Yes	[URL path segment] Calendar identifier of the source calendar where the event currently is on.
`destination`	Yes	[query parameter] Calendar identifier of the target calendar where the event is to be moved to.
`sendUpdates`	No	[query parameter] Guests who should receive notifications about the change of the event's organizer. Values: `all` = Notifications are sent to all guests.; `externalOnly` = Notifications are sent to non-Google Calendar guests only.; `none` = No notifications are sent. For calendar migration tasks, consider using the Events.import method instead..
`sendNotifications`	No	[query parameter] Deprecated. Please use sendUpdates instead. Whether to send notifications about the change of the event's organizer. Note that some emails might still be sent e

Output Schema

Name	Required	Description	Default
`id`	No
`end`	No
`etag`	No
`kind`	No
`start`	No
`gadget`	No
`locked`	No
`source`	No
`status`	No
`colorId`	No
`created`	No
`creator`	No
`iCalUID`	No
`summary`	No
`updated`	No
`htmlLink`	No
`location`	No
`sequence`	No
`attendees`	No
`eventType`	No
`organizer`	No
`reminders`	No
`recurrence`	No
`visibility`	No
`attachments`	No
`description`	No
`hangoutLink`	No
`privateCopy`	No
`eventLabelId`	No
`transparency`	No
`conferenceData`	No
`guestsCanModify`	No
`anyoneCanAddSelf`	No
`attendeesOmitted`	No
`recurringEventId`	No
`originalStartTime`	No
`birthdayProperties`	No
`endTimeUnspecified`	No
`extendedProperties`	No
`focusTimeProperties`	No
`guestsCanInviteOthers`	No
`outOfOfficeProperties`	No
`guestsCanSeeOtherGuests`	No
`workingLocationProperties`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedOct 26, 2026

changedInput schema / properties / calendarId / description

Previous value: -"Calendar identifier of the source calendar where the event currently is on."New value: +"[URL path segment] Calendar identifier of the source calendar where the event currently is on."

changedInput schema / properties / destination / description

Previous value: -"Calendar identifier of the target calendar where the event is to be moved to."New value: +"[query parameter] Calendar identifier of the target calendar where the event is to be moved to."

changedInput schema / properties / eventId / description

Previous value: -"Event identifier."New value: +"[URL path segment] Event identifier."

changedInput schema / properties / sendNotifications / description

Previous value: -"Deprecated. Please use sendUpdates instead. Whether to send notifications about the change of the event's organizer. Note that some emails might still be sent e"New value: +"[query parameter] Deprecated. Please use sendUpdates instead. Whether to send notifications about the change of the event's organizer. Note that some emails might still be sent e"

changedInput schema / properties / sendUpdates / description

Previous value: -"Guests who should receive notifications about the change of the event's organizer."New value: +"[query parameter] Guests who should receive notifications about the change of the event's organizer. Values: `all` = Notifications are sent to all guests.; `externalOnly` = Notifications are sent to non-Google Calendar guests only.; `none` = No notifications are sent. For calendar migration tasks, consider using the Events.import method instead.."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "anyoneCanAddSelf": {
+      "type": "boolean"
+    },
+    "attachments": {
+      "items": {
+        "properties": {
+          "fileId": {
+            "type": "string"
+          },
+          "fileUrl": {
+            "type": "string"
+          },
+          "iconLink": {
+            "type": "string"
+          },
+          "mimeType": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "attendees": {
+      "items": {
+        "properties": {
+          "additionalGuests": {
+            "type": "integer"
+          },
+          "asyncOperation": {
+            "type": "string"
+          },
+          "comment": {
+            "type": "string"
+          },
+          "displayName": {
+            "type": "string"
+          },
+          "email": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "optional": {
+            "type": "boolean"
+          },
+          "organizer": {
+            "type": "boolean"
+          },
+          "resource": {
+            "type": "boolean"
+          },
+          "responseStatus": {
+            "type": "string"
+          },
+          "self": {
+            "type": "boolean"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "attendeesOmitted": {
+      "type": "boolean"
+    },
+    "birthdayProperties": {
+      "properties": {
+        "contact": {
+          "type": "string"
+        },
+        "customTypeName": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "colorId": {
+      "type": "string"
+    },
+    "conferenceData": {
+      "properties": {
+        "conferenceId": {
+          "type": "string"
+        },
+        "conferenceSolution": {
+          "properties": {
+            "iconUri": {
+              "type": "string"
+            },
+            "key": {
+              "properties": {
+                "type": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "name": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "createRequest": {
+          "properties": {
+            "conferenceSolutionKey": {
+              "properties": {
+                "type": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "requestId": {
+              "type": "string"
+            },
+            "status": {
+              "properties": {
+                "statusCode": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "entryPoints": {
+          "items": {
+            "properties": {
+              "accessCode": {
+                "type": "string"
+              },
+              "entryPointFeatures": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "entryPointType": {
+                "type": "string"
+              },
+              "label": {
+                "type": "string"
+              },
+              "meetingCode": {
+                "type": "string"
+              },
+              "passcode": {
+                "type": "string"
+              },
+              "password": {
+                "type": "string"
+              },
+              "pin": {
+                "type": "string"
+              },
+              "regionCode": {
+                "type": "string"
+              },
+              "uri": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "notes": {
+          "type": "string"
+        },
+        "parameters": {
+          "properties": {
+            "addOnParameters": {
+              "properties": {
+                "parameters": {
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "signature": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "created": {
+      "type": "string"
+    },
+    "creator": {
+      "properties": {
+        "displayName": {
+          "type": "string"
+        },
+        "email": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "self": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "description": {
+      "type": "string"
+    },
+    "end": {
+      "properties": {
+        "date": {
+          "type": "string"
+        },
+        "dateTime": {
+          "type": "string"
+        },
+        "timeZone": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "endTimeUnspecified": {
+      "type": "boolean"
+    },
+    "etag": {
+      "type": "string"
+    },
+    "eventLabelId": {
+      "type": "string"
+    },
+    "eventType": {
+      "type": "string"
+    },
+    "extendedProperties": {
+      "properties": {
+        "private": {
+          "type": "object"
+        },
+        "shared": {
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
+    "focusTimeProperties": {
+      "properties": {
+        "autoDeclineMode": {
+          "type": "string"
+        },
+        "chatStatus": {
+          "type": "string"
+        },
+        "declineMessage": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "gadget": {
+      "properties": {
+        "display": {
+          "type": "string"
+        },
+        "height": {
+          "type": "integer"
+        },
+        "iconLink": {
+          "type": "string"
+        },
+        "link": {
+          "type": "string"
+        },
+        "preferences": {
+          "type": "object"
+        },
+        "title": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string"
+        },
+        "width": {
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "guestsCanInviteOthers": {
+      "type": "boolean"
+    },
+    "guestsCanModify": {
+      "type": "boolean"
+    },
+    "guestsCanSeeOtherGuests": {
+      "type": "boolean"
+    },
+    "hangoutLink": {
+      "type": "string"
+    },
+    "htmlLink": {
+      "type": "string"
+    },
+    "iCalUID": {
+      "type": "string"
+    },
+    "id": {
+      "type": "string"
+    },
+    "kind": {
+      "type": "string"
+    },
+    "location": {
+      "type": "string"
+    },
+    "locked": {
+      "type": "boolean"
+    },
+    "organizer": {
+      "properties": {
+        "displayName": {
+          "type": "string"
+        },
+        "email": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "self": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "originalStartTime": {
+      "properties": {
+        "date": {
+          "type": "string"
+        },
+        "dateTime": {
+          "type": "string"
+        },
+        "timeZone": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "outOfOfficeProperties": {
+      "properties": {
+        "autoDeclineMode": {
+          "type": "string"
+        },
+        "declineMessage": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "privateCopy": {
+      "type": "boolean"
+    },
+    "recurrence": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "recurringEventId": {
+      "type": "string"
+    },
+    "reminders": {
+      "properties": {
+        "overrides": {
+          "items": {
+            "properties": {
+              "method": {
+                "type": "string"
+              },
+              "minutes": {
+                "type": "integer"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "useDefault": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "sequence": {
+      "type": "integer"
+    },
+    "source": {
+      "properties": {
+        "title": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "start": {
+      "properties": {
+        "date": {
+          "type": "string"
+        },
+        "dateTime": {
+          "type": "string"
+        },
+        "timeZone": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "status": {
+      "type": "string"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "transparency": {
+      "type": "string"
+    },
+    "updated": {
+      "type": "string"
+    },
+    "visibility": {
+      "type": "string"
+    },
+    "workingLocationProperties": {
+      "properties": {
+        "customLocation": {
+          "properties": {
+            "label": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "homeOffice": {
+          "type": "any"
+        },
+        "officeLocation": {
+          "properties": {
+            "buildingId": {
+              "type": "string"
+            },
+            "deskId": {
+              "type": "string"
+            },
+            "floorId": {
+              "type": "string"
+            },
+            "floorSectionId": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

First observedOct 26, 2026

TDQS

A3.9/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Without annotations, the description carries the full burden and does well: it discloses that the call is an HTTP POST that creates or triggers a change, is refused under --readonly safety profiles, and returns the API's response resource as JSON. It still omits details like permission requirements, notification side effects, or whether the move is reversible.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description front-loads the core purpose and the key restriction, then covers mutation and return behavior efficiently. The trailing sibling list is long and not directly actionable, but the overall structure remains readable and not bloated.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 9 parameters, no annotations, and an existing output schema, the description covers the main behavioral traits needed to invoke it correctly: mutation nature, safety-profile refusal, event-type restrictions, and return format. It could be more complete with auth requirements or notification side effects, but the core invocation context is present.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 9 parameters in detail. The description adds only a general note that typed parameters win over the `params` map and that `body_file` can supply the whole body, which is useful but largely duplicative of the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Moves an event to another calendar, i.e. changes an event's organizer'), making the core purpose unmistakable. It lists sibling tools but does not differentiate when move should be used instead of update, patch, or import.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly excludes non-default event types (birthday, focusTime, fromGmail, outOfOffice, workingLocation) from being moved, which is a clear when-not rule. It does not explicitly name alternatives like update or import for other scenarios, so it falls short of a full usage-guidance 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server