Claw Calendar

Create, view, update, and delete calendar events using Claw Calendar API with natural language commands for scheduling and managing personal calendars.

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