Initial commit

commands/calendar-list.md

@@ -0,0 +1,40 @@
+---
+description: List calendar events with time filtering
+argument-hint: timerange
+---
+
+List calendar events with optional filtering.
+
+## Usage
+
+```bash
+google-gmail-tool calendar list [--today] [--this-week] [--query "TEXT"]
+```
+
+## Arguments
+
+- `--today`: Events for today
+- `--tomorrow`: Events for tomorrow
+- `--this-week`: Events this week (Monday-Sunday)
+- `--days N`: Events for next N days
+- `--query "TEXT"`: Search query (title, description, location)
+- `-n N`: Max results (default: 100)
+- `--text`: Output in text format
+- `-v/-vv/-vvv`: Verbosity (INFO/DEBUG/TRACE)
+
+## Examples
+
+```bash
+# List this week's events
+google-gmail-tool calendar list --this-week
+
+# Find meetings about project
+google-gmail-tool calendar list --query "project meeting"
+
+# Today's events in text format
+google-gmail-tool calendar list --today --text
+```
+
+## Output
+
+Returns JSON array with id, summary, start, end, location, attendees.