otherapi_key

Planyo Online Booking

Planyo is an online reservation system which can be used by any business taking bookings: for days, nights, hours or minutes, or scheduled events.

Verdict

Planyo Online Booking lets your team manage reservations, check availability, and handle customer bookings directly from Switchy. @mention it to create reservations after confirming resource availability, pull customer reviews before making decisions, or apply coupons during checkout. Most useful for operations teams juggling multiple bookable resources — venues, equipment, appointment slots — who need to check blackout dates or add users without switching tabs. Requires an API key from your Planyo account settings, which grants full read-write access to your booking data.

Common use cases

  • Check venue availability before client calls
  • Create reservations after confirming open slots
  • Pull customer reviews to inform booking decisions
  • Apply discount coupons during checkout flow
  • Block out maintenance windows across resources

Integration

Vendor
Planyo Online Booking
Category
other
Auth
API_KEY
Tools
7
Composio slug
planyo_online_booking

Tools

  • Add Reservation

    Tool to create a new reservation. Use after gathering resource, timing, and customer details.

  • Add User

    Tool to add a new user in Planyo. Use when you need to create a user account after gathering user details.

  • Get Add-on List

    Tool to retrieve a list of add-ons. Use when you need to inspect or manage add-ons for a specific resource or across the entire site after setting up credentials.

  • Get Coupon List

    Tool to retrieve a list of coupons. Use when you need to fetch all coupons for a specific resource or the entire site (if no resource_id provided).

  • Get Resource Availability

    Tool to check resource availability within a specified date/time range. Use when validating if a resource can be reserved before creating a reservation.

  • Get Resource Blackouts

    Tool to fetch blackout periods for a resource. Use when determining unavailable timeslots before booking.

  • Get Resource Reviews

    Tool to fetch reviews and ratings for a specific resource. Use when you have a resource_id and need to display customer feedback.

Setup

Setup guide

  1. 11. In Switchy, open the Space where you want booking access and click 'Add Integration' from the sidebar. 2. Search for 'Planyo Online Booking' and select it. 3. You'll be prompted for an API key — log into your Planyo dashboard, navigate to Settings > API Access, and generate a new key (copy it immediately, as Planyo won't show it again). 4. Paste the key into Switchy and click 'Connect'. 5. Switchy confirms the connection and lists the seven tools now available. 6. Test it by typing '@Planyo get resource availability' in a message, specifying a resource ID and date range — the MCP should return open slots. 7. If you see availability data, the integration is live and ready for reservation workflows.

What teammates see: by default, memories from Planyo Online Booking are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Check Availability

@Planyo check availability for resource ID 12345 from January 15 to January 20, 2025. Show me all open time slots.
Open in a Space →

Create Reservation

@Planyo create a reservation for resource ID 12345 on January 18, 2025 from 2pm to 5pm for customer Jane Doe, email jane@example.com.
Open in a Space →

Fetch Customer Reviews

@Planyo get all reviews for resource ID 12345. Summarize the average rating and highlight any recurring themes.
Open in a Space →

List Active Coupons

@Planyo show me all active coupons for resource ID 12345. Include expiration dates and discount amounts.
Open in a Space →

View Blackout Periods

@Planyo fetch blackout periods for resource ID 12345 in February 2025. List the dates and reasons.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@planyo check availability for resource 12345 from March 15-20, then show me any blackout periods that might conflict

Output

Based on the Planyo API response, resource 12345 appears available March 15-20 with no existing reservations blocking those dates. However, there's a blackout period March 17-18 (marked as 'maintenance window') that would prevent bookings. The resource shows open slots March 15-16 and March 19-20. This example illustrates how the MCP queries availability and blackout data in sequence to give you a complete booking picture.

Notes

This example combines two read operations (availability check + blackout fetch) to surface scheduling conflicts. Requires valid resource_id and API key with read permissions. Planyo's availability API returns time-granular data, so responses can be verbose for resources with hourly slots.

Prompt

@planyo create a reservation for resource 12345 on March 19 from 2-5pm for customer Jane Doe, email jane@example.com

Output

Reservation created successfully. Planyo returned reservation ID 98765 for resource 12345, scheduled March 19, 14:00-17:00. Customer Jane Doe (jane@example.com) will receive a confirmation email per your site's notification settings. This example shows the MCP executing a write operation that commits data to Planyo's live system—the reservation now appears in your dashboard and triggers any configured workflows.

Notes

This write operation creates a real booking in your Planyo account. Requires API key with reservation-creation permissions. Side-effect: customer receives email, resource becomes unavailable for that slot, and any payment/deposit rules in your Planyo config apply immediately. Always verify availability first.

Prompt

@planyo pull reviews for resource 12345 and draft a short marketing blurb highlighting the top-rated aspects customers mention

Output

Fetched 23 reviews for resource 12345 (average rating 4.6/5). Customers consistently praise the 'spotless condition' (mentioned in 18 reviews) and 'responsive host communication' (14 mentions). Draft blurb: 'Guests love our meticulously maintained space and our team's quick responses—rated 4.6/5 by over 20 recent visitors.' This example demonstrates the MCP retrieving structured review data, then using AI reasoning to synthesize customer sentiment into marketing copy.

Notes

This synthesis example pairs Planyo's review API with the AI's summarization capability. Useful for generating social proof or identifying service gaps. Note that review volume and detail vary by resource—newly listed resources may return empty datasets. Requires read permissions on reviews.

Use-case deep-dives

Coworking space booking triage

When Planyo MCP works for daily desk reservations

A 6-person operations team managing a 40-desk coworking space uses Planyo to handle member bookings. The MCP shines here because the team needs to check availability, create reservations, and apply member coupons without leaving their AI workspace during morning check-ins. The Get Resource Availability and Add Reservation tools handle the 80% case—walk-in requests and same-day changes. The coupon tool lets them apply discounts inline when members ask about pricing. The threshold: if you're managing complex multi-resource bundles (conference room plus catering plus AV), Planyo's native UI is faster because the MCP doesn't expose package logic. For straightforward desk and meeting-room bookings under 100 reservations per week, this MCP cuts your context-switching in half.

Fitness studio class scheduling

Why Planyo MCP falls short for high-frequency class bookings

A 3-person studio running 15 yoga classes per week tried using the Planyo MCP to manage drop-in reservations during peak hours. The problem: the MCP's 7 tools don't include batch operations or waitlist management, so handling 8 simultaneous booking requests for a single class means 8 separate Add Reservation calls. The Get Resource Blackouts tool helps block instructor time-off, but there's no way to auto-confirm from a waitlist when someone cancels. If your booking volume stays under 30 reservations per day and you're mostly doing admin tasks—adding users, checking reviews, pulling coupon reports—the MCP saves time. Above that threshold, you're better off keeping Planyo's dashboard open. This integration is for low-frequency booking workflows, not high-throughput class scheduling.

Vacation rental inquiry response

When this MCP speeds up guest communication for small hosts

A 2-person property management team handling 5 vacation rentals uses the Planyo MCP to answer guest inquiries in Slack without opening the booking dashboard. When a potential guest asks about availability for a long weekend, the team checks Get Resource Availability and Get Resource Reviews in one AI prompt, then drafts a response with pricing and recent feedback. The Add Reservation tool closes the loop if the guest confirms. The win: the entire inquiry-to-booking flow happens in the team's existing chat workspace. The limit: Planyo's API key auth means the MCP can't differentiate between team members, so audit trails show all actions under one account. If you need per-user attribution or you're managing more than 10 properties, the lack of granular permissions becomes a problem. For small hosts doing under 50 bookings per month, this MCP eliminates 70% of dashboard visits.

Frequently asked

What does the Planyo MCP let me do in Switchy?

It connects your Planyo booking system so AI agents can check resource availability, create reservations, manage users, and pull reviews or coupons—all without leaving the conversation. Think of it as giving your team a natural-language interface to your booking calendar, so you can confirm slots or add customers on the fly instead of switching tabs.

Do I need admin access to connect Planyo?

You need a Planyo API key, which typically requires account-owner or admin permissions to generate. Once you paste that key into Switchy, the MCP can read availability, create reservations, and manage users across all resources in your site. If your Planyo plan restricts API access, you won't be able to authenticate.

Can the Planyo MCP modify existing reservations or cancel bookings?

The seven tools exposed focus on creating reservations and reading data—availability, blackouts, reviews, coupons, add-ons. Modifying or cancelling existing bookings isn't listed, so you'll still need to handle changes directly in Planyo's dashboard or via a custom API call outside this MCP.

Why use this instead of just logging into Planyo?

Speed and context. When a customer asks "Do you have a two-hour slot Thursday afternoon?", an agent can query availability and book it in one thread instead of you alt-tabbing to Planyo, filtering dates, and copying confirmation details back. It's faster for high-volume booking conversations, but the Planyo UI still wins for bulk calendar edits.

Who on my team should connect the Planyo integration?

Whoever holds your Planyo admin credentials and understands which resources and add-ons matter. Once connected, any Switchy workspace member can invoke the tools through an agent—so lock down your workspace invites if you don't want junior staff creating reservations unsupervised. The API key itself lives in your integration settings, not per-user.

Data last verified 608 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.