Zoho Bookings
The Zoho Bookings connector lets AI agents check availability and book, reschedule, or cancel appointments for services and staff. It uses OAuth 2.0 so your credentials are stored encrypted in MCPGate's vault and are never exposed to the AI client.
Required scopes#
MCPGate requests the following OAuth scopes when you connect a Zoho Bookings account.
| Scope | Purpose |
|---|---|
| zohobookings.data.CREATE | Book new appointments |
| zohobookings.data.READ | Read appointments, services, staff, and availability |
| zohobookings.data.UPDATE | Reschedule existing appointments |
Tool reference#
The Zoho Bookings connector exposes 10 tools. Use the MCP Apps page to enable or disable individual tools per app, and the Guardrails page to add fine-grained rules on top.
| Tool | Category | Description |
|---|---|---|
| zohobookings_list_appointments | read | List appointments in Zoho Bookings |
| zohobookings_get_appointment | read | Get a specific appointment by ID from Zoho Bookings |
| zohobookings_list_services | read | List services in Zoho Bookings |
| zohobookings_list_staff | read | List staff members in Zoho Bookings |
| zohobookings_list_workspaces | read | List workspaces in Zoho Bookings |
| zohobookings_list_availability | read | List availability slots in Zoho Bookings |
| zohobookings_get_availability | read | Get available time slots for a specific date and service in Zoho Bookings |
| zohobookings_book_appointment | write | Book a new appointment in Zoho Bookings |
| zohobookings_reschedule_appointment | write | Reschedule an existing appointment in Zoho Bookings |
| zohobookings_cancel_appointment | delete | Cancel an appointment in Zoho Bookings |
Booking sends confirmation emails to customers
zohobookings_book_appointment triggers a booking confirmation email to the customer email address provided. Always test with internal email addresses in development to avoid sending confirmation emails to real customers.Common guardrail recipes#
Read-only access#
Apply the read_only preset to enable the seven read tools and deny all write and delete tools. Suitable for scheduling assistant agents that check availability and list upcoming appointments without making any bookings.
Book preset#
Use the book preset to enable all 10 tools. This gives agents the full booking workflow — checking availability, booking, rescheduling, and cancelling appointments on behalf of customers.
Restrict to specific services#
Apply a allow_values guardrail to zohobookings_book_appointment targeting the service_id field with the IDs of services the agent is permitted to book. Use zohobookings_list_services to retrieve the service IDs.
Troubleshooting#
- No available slots — If
zohobookings_get_availabilityreturns no slots, the staff member may have blocked the date or the service duration does not fit within available working hours. Check the Zoho Bookings dashboard for calendar conflicts. - Service ID vs service name — Zoho Bookings uses numeric service IDs in the API, not display names. Use
zohobookings_list_servicesto map names to IDs before calling booking tools. - Cancellation notifies the customer —
zohobookings_cancel_appointmentsends a cancellation email. Ensure the agent only cancels appointments when explicitly instructed by the user, not as part of a cleanup routine.