Claw Calendar#

Overview#

This skill enables AI assistants to interact with Claw Calendar, a calendar management API. It provides the ability to create, view, update, and delete calendar events through natural language commands.

How to Use#

When user wants to create/manage calendar events:

1. Check if user has configured:

   • CALENDAR_API_BASE_URL (e.g., https://claw-calendar.com)
   • CALENDAR_API_KEY (API Key from Claw Calendar settings)

2. If not configured, tell user to configure these environment variables in WorkBuddy settings.

3. If configured, use the API endpoints below.

API Authentication#

IMPORTANT: Use X-API-Key header, NOT Authorization: Bearer

text

Headers:
  X-API-Key: ${CALENDAR_API_KEY}

API Endpoints#

Base URL: ${CALENDAR_API_BASE_URL}

List Calendars#

text

GET /api/calendars
Headers: X-API-Key: ${CALENDAR_API_KEY}

Create Event#

text

POST /api/calendars/{calendarId}/events
Headers:
  X-API-Key: ${CALENDAR_API_KEY}
  Content-Type: application/json
Body: {
  "title": "Event Title",
  "startDate": "YYYY-MM-DD",
  "endDate": "YYYY-MM-DD",
  "startTime": "HH:mm (optional)",
  "endTime": "HH:mm (optional)",
  "isAllDay": true,
  "description": "optional",
  "location": "optional",
  "alarmEnabled": true,
  "alarmMinutes": 15
}

List Events#

text

GET /api/events
Headers: X-API-Key: ${CALENDAR_API_KEY}

Update Event#

text

PUT /api/calendars/{calendarId}/events/{eventId}
Headers: X-API-Key: ${CALENDAR_API_KEY}

Delete Event#

text

DELETE /api/calendars/{calendarId}/events/{eventId}
Headers: X-API-Key: ${CALENDAR_API_KEY}

Response Format#

Success: { "success": true, event/calendars/events: {...} } Error: { "success": false, error: { code, message } }

Parsing Examples#

• "明天上午10点会议" → tomorrow, 10:00
• "下周三生日派对" → next Wednesday
• "今天下午3-4点面试" → today, 15:00-16:00

Defaults: isAllDay=true if no time, alarmMinutes=15, endDate=same as startDate