ticruz38 Calendar Skill
Read and manage Google Calendar events.
Capabilities
GET /events?days=7- List upcoming events- Returns:
{ "events": [...] }
- Returns:
POST /events- Create new event- Body:
{ "title": "...", "start": "...", "end": "..." } - Returns:
{ "success": true, "id": "..." }
- Body:
GET /free-slots?date=2024-01-15&duration=60- Find free time slots- Returns:
{ "slots": ["09:00", "14:00"] }
- Returns:
GET /health- Health check- Returns:
{ "status": "healthy" }
- Returns:
Setup
Requires Google OAuth credentials. During onboarding, you'll authorize access to your calendar.
Environment Variables
| Variable | Required | Description |
|---|---|---|
GOOGLE_REFRESH_TOKEN |
Yes | OAuth refresh token |
GOOGLE_CLIENT_ID |
Yes | OAuth client ID |
GOOGLE_CLIENT_SECRET |
Yes | OAuth client secret |
GOOGLE_CALENDAR_ID |
No | Calendar ID (default: primary) |
PORT |
No | HTTP port (default: 5000) |
Examples
# Start the service
python3 calendar.py
# List events
curl http://localhost:5000/events?days=7
# Create event
curl -X POST http://localhost:5000/events \
-H "Content-Type: application/json" \
-d '{"title":"Meeting","start":"2024-01-15T10:00:00","end":"2024-01-15T11:00:00"}'