create_calendar_event
Create new events in Google Calendar with details like title, time, location, attendees, and color coding.
Instructions
Create a new event in the user's Google Calendar.
This tool creates a new calendar event with the specified details.
Prerequisites:
- The user must be authenticated with Google Calendar access
Args:
summary (str): The title/summary of the event
start_time (str): The start time of the event in ISO format (YYYY-MM-DDTHH:MM:SS) or simple date/time format ("5pm", "tomorrow 3pm")
end_time (str, optional): The end time of the event. If not provided, you should ask the user for this information.
description (str, optional): Description or notes for the event. If not provided, leave it blank.
location (str, optional): Location of the event. If not provided, leave it blank.
attendees (List[str], optional): List of email addresses of attendees. The current user will always be added automatically.
color_name (str, optional): Color name for the event (e.g., "red", "blue", "green", "purple", "yellow", "orange")
Returns:
Dict[str, Any]: The result of the operation, including:
- success: Whether the operation was successful
- message: A message describing the result
- event_id: The ID of the created event
- event_link: Direct link to the event in Google Calendar
- missing_info: List of missing information that should be asked from the user
Example usage:
1. Create a simple event:
create_calendar_event(summary="Team Meeting", start_time="2023-12-01T14:00:00")
2. Create a detailed event:
create_calendar_event(
summary="Project Kickoff",
start_time="next monday at 10am",
end_time="next monday at 11:30am",
description="Initial meeting to discuss project scope",
location="Conference Room A",
attendees=["colleague@example.com", "manager@example.com"],
color_id="2"
)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| summary | Yes | ||
| start_time | Yes | ||
| end_time | No | ||
| description | No | ||
| location | No | ||
| attendees | No | ||
| color_name | No |