# Calendar

> Google Calendar integration

- Skill: `ticruz38/calendar-2` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add ticruz38/calendar-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ticruz38/calendar-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: ticruz38 (https://skillmd.com/u/ticruz38)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ticruz38/calendar-2

---


# Calendar Skill

Read and manage Google Calendar events.

## Capabilities

- `GET /events?days=7` - List upcoming events
  - Returns: `{ "events": [...] }`
  
- `POST /events` - Create new event
  - Body: `{ "title": "...", "start": "...", "end": "..." }`
  - Returns: `{ "success": true, "id": "..." }`
  
- `GET /free-slots?date=2024-01-15&duration=60` - Find free time slots
  - Returns: `{ "slots": ["09:00", "14:00"] }`

- `GET /health` - Health check
  - Returns: `{ "status": "healthy" }`

## 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

```bash
# 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"}'
```