Planyo Online Booking MCP server

Connect Planyo Online Booking to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Planyo Online Booking MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list vouchers tool in Planyo Online Booking
  • Use the modify user tool in Planyo Online Booking
  • Use the record payment tool in Planyo Online Booking
  • Use the list reservations tool in Planyo Online Booking
  • Use the modify reservation tool in Planyo Online Booking
  • Use the create user tool in Planyo Online Booking

Supported Tools

list_vouchers

List Vouchers

Lists vouchers with optional filtering by rental dates, resource, and code prefix. Returns voucher details including usage counts and discount values.

modify_user

Modify User

Modifies an existing user's personal details, contact info, custom properties, and account flags. Identify the user by ID or email.

record_payment

Record Payment

Records a payment against a reservation. Specify the payment method, status, amount, and a unique transaction identifier. **Payment modes**: 2=Cash, 3=Cheque, 4=Bank transfer, 5=Other, 6=Gift certificate, 9=Discount, 10=Credit card on file, 1=PayPal. **Payment statuses**: 1=Successful, 2=Pending, 3=Error, 4=Refund.

list_reservations

List Reservations

Searches and lists reservations within a time period. Filter by resource, customer, status, modification date, and custom properties. Supports pagination (up to 500 per page).

modify_reservation

Modify Reservation

Modifies an existing reservation. Can change the resource, time period, quantity, assigned user, and custom form fields. By default, the price is recalculated after modifications.

create_user

Create User

Creates a new customer user or updates an existing user's custom properties. If a user with the given email already exists, their custom properties and personal details are updated (login credentials remain unchanged).

reservation_action

Reservation Action

Performs an administrative action on a reservation such as confirming, cancelling, checking in/out, marking as no-show, or other status changes. Available actions: **Confirm**, **Cancel** (admin cancel), **User_cancel** (customer cancel), **Checkin**, **Checkout**, **Noshow**, **Clear_checkin**, **Clear_noshow**, **Unconfirm**, **Uncancel**, **Lock**, **Unlock**, **Preapprove**, **Verify**, **Mark_as_quote**, **Promote** (from waitlist).

list_resources

List Resources

Lists bookable resources with optional filtering by publish status, resource type, and custom properties. Supports pagination (up to 100 per page).

create_voucher

Create Voucher

Creates a new voucher (discount code) that customers can apply to reservations. Supports percentage or fixed-amount discounts, resource restrictions, and date limitations.

list_users

List Users

Searches and lists customer users with filtering by name, email, location, and custom properties. Supports wildcard search using `*` character. Paginated results (up to 1000 per page).

get_resource_usage

Get Resource Usage

Retrieves usage (occupancy) data for a resource or all resources over a date range. Returns grouped time periods with the number of units occupied in each period. Useful for understanding booking density and remaining availability.

get_resource

Get Resource

Retrieves detailed information about a single bookable resource including availability settings, pricing, booking rules, photos, properties, and admin details.

list_payments

List Payments

Lists payments within a date range. Can filter by resource and payment method. Returns payment details including amount, status, customer info, and associated reservation.

check_availability

Check Availability

Checks whether a reservation can be made for a resource during a given time period. Uses the comprehensive `can_make_reservation` check which considers all booking constraints (not just availability). Optionally returns the calculated price.

get_user

Get User

Retrieves detailed information about a customer user by ID or email, including personal details, contact info, custom properties, and reservation count.

get_rental_price

Get Rental Price

Calculates the rental price for a resource given a time period, quantity, and optional voucher code. Returns the total price along with a breakdown of applied pricing rules and products.

get_site_info

Get Site Info

Retrieves site-level information including name, category, timezone, admin email, custom resource property definitions, and photos.

get_reservation

Get Reservation

Retrieves complete details of a single reservation including customer info, pricing, payments, custom properties, additional products, and activity log.

delete_reservation

Delete Reservation

Permanently deletes a reservation. **This cannot be undone.** For non-permanent removal, use the Reservation Action tool with action "Cancel" instead.

create_reservation

Create Reservation

Creates a new reservation for a bookable resource. Specify the resource, time period, quantity, and customer details (either by providing an existing user ID or by supplying email and name). Supports custom form fields, voucher codes, pricing overrides, and shopping cart grouping.

search_reservations

Search Reservations

Finds reservations by customer name, login, user ID, reservation ID, email, phone number, or resource name without requiring a date range. Use the returned reservation IDs to retrieve details or perform reservation actions.

search_resources

Search Available Resources

Finds available resources for a rental period and quantity, with prices and optional custom property filters. Use the returned resource IDs to create a reservation.

Connect Planyo Online Booking to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Planyo Online Booking in Metorial. In your Metorial portal, enable the Planyo Online Booking MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Planyo Online Booking tools.

Run Planyo Online Booking through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Planyo Online Booking and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Planyo Online Booking tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Planyo Online Booking

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Calendly

List, retrieve, and cancel scheduled events. Book meetings programmatically on behalf of invitees using available time slots. Retrieve event types and their configurations. Query user availability, available time slots, busy times, and availability schedules. Create single-use scheduling links with optional overrides. List and manage invitees, mark no-shows, and access custom question responses and UTM tracking data. Manage organization memberships, invite or remove users. Retrieve routing form configurations and submissions. Subscribe to webhooks for new bookings, cancellations, and routing form submissions.

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Zoho

Manage Zoho CRM, Bigin, Books, Inventory, Invoice, Desk, Mail, People, and Projects from one connection. Discover organizations and accounts, manage records and financial documents, work with support tickets and email, and organize employee and project data.

Quickbooks

Manage business finances and accounting in QuickBooks Online. Create, send, and track invoices. Manage bills and accounts payable, record bill payments. Create and update customer and vendor records with contact details and hierarchies. Record payments against invoices and credit memos. Create estimates, sales receipts, and journal entries. Track expenses and categorize against the chart of accounts. Manage items, products, services, and inventory levels. Query entities using SQL-like syntax and sync incremental changes via Change Data Capture. Generate financial reports including profit and loss, balance sheet, and cash flow. Process credit card and bank account (ACH) payments via the Payments API. Manage the chart of accounts for tracking income, expenses, assets, and liabilities.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Technical notes for Planyo Online Booking

Create, modify, cancel, and search reservations for bookable resources such as vacation properties, car rentals, hotels, equipment, and event spaces. Manage resource availability, vacations, and weekly schedules. Configure pricing rules, calculate rental prices, and handle seasonal pricing. Record and track payments against reservations. Create and manage customers, assign roles, and search users by custom properties. Define additional products, coupons, and vouchers for reservations. Generate invoices, send customer emails, and sync availability via iCal feeds. Manage site and meta-site settings, notification templates, and webhook callbacks for reservation lifecycle, payment, check-in/check-out, and scheduling events.

Frequently asked questions

Common questions about connecting Planyo Online Booking to AI agents with Metorial.

  1. How many tools does the Planyo Online Booking MCP server have?
    The Planyo Online Booking MCP server exposes 22 tools, including List Vouchers, Modify User, Record Payment. Each one is governed and traced through Metorial.
  2. Planyo Online Booking exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Planyo Online Booking MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Planyo Online Booking and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Planyo Online Booking MCP server yourself or use the hosted gateway.

Connect Planyo Online Booking to production AI agents

See how Metorial gives your team governed access to Planyo Online Booking, with tracing and security controls built in.