Calendar Update Event

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

DESTRUCTIVEgoogle.calendar_update_event

• Contract tier: agent_ready
• Risk: destructive
• Catalog version: google-2026.07.12.2
• Descriptor hash: 4741129b5ded14ef1ea11a9e467b050f2b82402dbe44b235629191fb56741fd0

Use this destructive Google Calendar tool to patch an existing event. It can overwrite event details and send attendee updates. It can overwrite, send, move, remove, or permanently delete Google data. Use it only after preview and the manifest-defined confirmation; it requires per-request Google OAuth.

Request Body

{
  "jsonrpc": "2.0",
  "id": "google-calendar-update-event-example",
  "method": "tools/call",
  "params": {
    "name": "google.calendar_update_event",
    "arguments": {
      "calendar_id": "calendar_id_123",
      "event_id": "event_id_123",
      "event_patch": {},
      "send_updates": "all"
    }
  }
}

Arguments Schema

{
  "type": "object",
  "title": "calendar_update_eventArguments",
  "required": [
    "calendar_id",
    "event_id",
    "event_patch"
  ],
  "properties": {
    "event_id": {
      "type": "string",
      "title": "Event Id",
      "description": "Google Calendar event ID."
    },
    "calendar_id": {
      "type": "string",
      "title": "Calendar Id",
      "description": "Google Calendar calendar ID, often 'primary'."
    },
    "event_patch": {
      "type": "object",
      "title": "Event Patch",
      "description": "Google Calendar events.patch request body.",
      "additionalProperties": true
    },
    "send_updates": {
      "enum": [
        "all",
        "externalOnly",
        "none"
      ],
      "type": "string",
      "title": "Send Updates",
      "default": "all",
      "description": "How Google Calendar should notify attendees."
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "ok",
    "data",
    "error",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the local or Google provider operation completed successfully."
    },
    "data": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Bounded local navigation or Google provider result when ok is true."
    },
    "meta": {
      "type": "object",
      "description": "Safe timing, pagination, cache, request, and truncation metadata.",
      "additionalProperties": true
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "description": "Safe structured error when ok is false."
    }
  },
  "description": "Google MCP normalized operation envelope.",
  "additionalProperties": false
}

Code Examples

cURL

curl -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "google-calendar-update-event-example",
  "method": "tools/call",
  "params": {
    "name": "google.calendar_update_event",
    "arguments": {
      "calendar_id": "calendar_id_123",
      "event_id": "event_id_123",
      "event_patch": {},
      "send_updates": "all"
    }
  }
}'

Node.js

const response = await fetch('https://portal.madpanda3d.com/api/mcp', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer mad_live_***',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "id": "google-calendar-update-event-example",
  "method": "tools/call",
  "params": {
    "name": "google.calendar_update_event",
    "arguments": {
      "calendar_id": "calendar_id_123",
      "event_id": "event_id_123",
      "event_patch": {},
      "send_updates": "all"
    }
  }
}),
});
const data = await response.json();
console.log(data);

Python

import requests

url = 'https://portal.madpanda3d.com/api/mcp'
headers = {
    'Authorization': 'Bearer mad_live_***',
    'Content-Type': 'application/json',
}
payload = {
  "jsonrpc": "2.0",
  "id": "google-calendar-update-event-example",
  "method": "tools/call",
  "params": {
    "name": "google.calendar_update_event",
    "arguments": {
      "calendar_id": "calendar_id_123",
      "event_id": "event_id_123",
      "event_patch": {},
      "send_updates": "all"
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

{
  "ok": true,
  "message": "Tool google.calendar_update_event executed successfully.",
  "note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}

502 Upstream Error

{
  "ok": false,
  "classification": "upstream_http_error",
  "message": "Upstream MCP returned a non-success status."
}