---
title: "Check Calendar"
method: POST
path: "/api/focused/tools/check_calendar"
tags: ["focused-tools"]
---

# Check Calendar

`POST /api/focused/tools/check_calendar`

MCP tool → backend endpoint.
Loads:
    - system default keywords
    - user custom keywords
Identifies focus blocks from Google Calendar.

Identity Source (Increment 7D):
    - Primary: X-User-ID header (from MCP after JWT validation)
    - Fallback: hardcoded test_user (for backward compatibility)
    - Logs warning if fallback is used

## Request body

- CheckCalendarRequest — Request model for check_calendar endpoint.
  - `time_start` string, nullable — ISO8601 start time. None = now.
  - `time_end` string, nullable — ISO8601 end time. None = start + 7 days.
  - `max_results` integer — Max events to scan (1-50)

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/priority-guard/apis/priority-guardian.md) · [All operations](https://skmtc.net/priority-guard/apis/priority-guardian/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/priority-guard/priority-guardian/revisions/8579218b716d/schema)