suggest_meeting_times
Analyze your Google Calendar to find available time slots for scheduling meetings within a specified date range, respecting your existing events and working hours.
Instructions
Suggest available meeting times within a date range.
This tool analyzes the user's calendar and suggests available time slots
for scheduling meetings based on their existing calendar events.
Prerequisites:
- The user must be authenticated with Google Calendar access
Args:
start_date (str): The start date of the range to check (can be natural language like "tomorrow")
end_date (str): The end date of the range to check (can be natural language like "next friday")
duration_minutes (int, optional): The desired meeting duration in minutes. Defaults to 60.
working_hours (str, optional): Working hours in format "9-17" (9am to 5pm). Defaults to 9am-5pm.
Returns:
Dict[str, Any]: The suggested meeting times including:
- success: Whether the operation was successful
- suggestions: List of suggested meeting times with formatted date/time
- message: A message describing the result
Example usage:
1. Find meeting times for tomorrow:
suggest_meeting_times(start_date="tomorrow", end_date="tomorrow")
2. Find meeting times for next week with custom duration:
suggest_meeting_times(
start_date="next monday",
end_date="next friday",
duration_minutes=30
)
3. Find meeting times with custom working hours:
suggest_meeting_times(
start_date="tomorrow",
end_date="friday",
working_hours="10-16"
)
Important:
- The tool respects the user's existing calendar events
- Suggestions are limited to working hours (default 9am-5pm)
- Weekends are excluded by default
- The tool will return at most 10 suggestions
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| start_date | Yes | ||
| end_date | Yes | ||
| duration_minutes | No | ||
| working_hours | No |