savvycal_list_events
List scheduled (and canceled) meetings from your SavvyCal account.
Use this to answer questions like:
- "What meetings do I have this week?"
- "Show me all bookings in March"
- "Did anyone cancel recently?"
Args:
- after (string, optional): ISO 8601 date — only return events starting after this date (e.g. "2026-03-01" or "2026-03-01T09:00:00Z")
- before (string, optional): ISO 8601 date — only return events starting before this date
- limit (number, optional): Max events to return, 1–100 (default: 20)
- cursor_after (string, optional): Pagination cursor from a previous response's metadata.after field
- response_format ("markdown" | "json"): Output format (default: "markdown")
Returns (markdown): Formatted list of events with status, time, attendees, and join links.
Returns (json): Structured data with entries array and pagination metadata.
Examples:
- "Show my next 5 meetings" → after=today's date, limit=5
- "List all meetings this month" → after=start of month, before=end of month
savvycal_get_event
Fetch full details for a single SavvyCal event by its ID.
Use this to:
- Get the Zoom/Meet join link for a specific meeting
- Check all attendees for a booking
- Verify the status of a specific event
Args:
- id (string, required): The event ID (e.g. "event_01ED74HMFGVZ92YVCWTD8Y8H6X") — get this from savvycal_list_events
- response_format ("markdown" | "json"): Output format (default: "markdown")
Returns: Full event details including conferencing join URL, all attendees, location, and payment info.
savvycal_cancel_event
Cancel a scheduled SavvyCal event. This action cannot be undone.
Use this when:
- A meeting needs to be canceled
- A booking should be removed from your calendar
Args:
- id (string, required): The event ID to cancel — get from savvycal_list_events
- response_format ("markdown" | "json"): Output format (default: "markdown")
Returns: The updated event with state set to "canceled".
⚠️ This permanently cancels the meeting. The attendee may receive a cancellation notification.
savvycal_create_event
Book a meeting on a SavvyCal scheduling link for a specific time slot.
Use this to:
- Book a meeting on behalf of someone
- Schedule a meeting at a specific available slot
Args:
- link_slug (string, required): Scheduling link slug (e.g. "intro-call") — get from savvycal_list_scheduling_links
- starts_at (string, required): ISO 8601 datetime for the meeting start — must match an available slot from savvycal_get_available_slots
- name (string, required): Full name of the attendee being booked
- email (string, required): Email address of the attendee
- description (string, optional): Optional note or message for the booking
Returns: The newly created event with all details including any conferencing join link.
Workflow: Use savvycal_list_scheduling_links to find the link slug, then savvycal_get_available_slots to find valid times, then this tool to book.
savvycal_list_scheduling_links
List all scheduling links in your SavvyCal account.
Use this to:
- See all your booking types (intro calls, consultations, etc.)
- Find a link slug to use with savvycal_get_available_slots or savvycal_create_event
- Check which links are currently active or inactive
Args:
- limit (number, optional): Max links to return, 1–100 (default: 20)
- cursor_after (string, optional): Pagination cursor from a previous response
- response_format ("markdown" | "json"): Output format (default: "markdown")
Returns: List of scheduling links with name, slug, duration, status, and URL.
savvycal_get_available_slots
Get available time slots for a scheduling link within a date range.
Use this to:
- Answer "when am I free for a 30-minute call next week?"
- Find valid times before booking with savvycal_create_event
- Show someone your open availability
Args:
- link_slug (string, required): Scheduling link slug (e.g. "intro-call") — get from savvycal_list_scheduling_links
- after (string, optional): ISO 8601 date — show slots after this date (defaults to now)
- before (string, optional): ISO 8601 date — show slots before this date
- response_format ("markdown" | "json"): Output format (default: "markdown")
Returns: List of available time slots with start and end times.
Workflow: Use savvycal_list_scheduling_links to find the slug first, then call this tool.