Files
gh-dnvriend-google-gmail-to…/commands/calendar-list.md
2025-11-29 18:23:24 +08:00

41 lines
926 B
Markdown

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