## §OIP SYSTEM ARTICLE — GCAL (3 operations)
A generated article for one OIP shelf. It lists every operation in this API/CLI/MCP/device/model/core subsystem, links each leaf article, and gives the ledger path for proof.

### Read Order
- scan operations
- open a leaf doc
- run via run_now or POST /api/dispatch
- open receipt
- repair/replay if needed

### Operations
- **GCAL_CALENDARS_LIST** — Every calendar the connected Google account can see.
  when: find the calendar id before listing events.
  args: none
  doc: https://miscsubjects.com/api/dispatch?key=GCAL_CALENDARS_LIST&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=GCAL_CALENDARS_LIST&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=GCAL_CALENDARS_LIST
- **GCAL_EVENTS_UPCOMING** — Upcoming events on the primary calendar from a start time.
  when: what is on the calendar today or this week.
  args: $1 = max results (e.g. 10) · $2 = RFC3339 start, e.g. 2026-09-11T00:00:00Z
  doc: https://miscsubjects.com/api/dispatch?key=GCAL_EVENTS_UPCOMING&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=GCAL_EVENTS_UPCOMING&body=10%7C2026-09-11T00%3A00%3A00Z&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=GCAL_EVENTS_UPCOMING
- **GCAL_MCP_EVENTS** — Events on the owner primary calendar between two times (Calendar MCP).
  when: what is on the calendar.
  args: $1 = ISO 8601 start · $2 = ISO 8601 end
  doc: https://miscsubjects.com/api/dispatch?key=GCAL_MCP_EVENTS&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=GCAL_MCP_EVENTS&body=2026-09-11T00%3A00%3A00Z%7C2026-09-18T00%3A00%3A00Z&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=GCAL_MCP_EVENTS

### Troubleshooting
- If a row's example has placeholders, replace only the placeholder values and preserve separators.
- If a call fails, open its receipt and repair it with POST /api/dispatch {key, body, repairs:'inv_ID'}.
- If token scope denies this system, ask the owner for a row:/rows:/pfx: token scoped to the exact operation set.

Back to the tree: https://miscsubjects.com/api/dispatch?map=1&format=markdown