Connect Claude Code, Codex, OpenClaw or Hermes to VillaSlot to review villas, check availability and manage bookings with an organization API key.
A client needs a villa for a two-hour photoshoot. Before replying, you need to find availability, check the price and make sure the slot leaves enough time to prepare the venue. That information already exists in VillaSlot. An AI agent can look it up for you and prepare the next steps from your request.
Getting started takes two things: the VillaSlot skill and an API key for your organization. The skill tells the agent how to use the application. The key gives it access to your data with your permissions.
The agent works with villa listings and bookings inside VillaSlot. It does not automatically publish listings on Airbnb or other platforms.
| Your request | What the agent can do in VillaSlot |
|---|---|
| “Show me my villas” | List venues and read their information |
| “Update this listing” | Rename a villa or add a photo |
| “Which slots are available?” | Read opening hours, priced durations and availability |
| “Prepare this booking” | Find the customer and create an hourly booking as instructed |
| “The client wants to reschedule” | Check another slot and move the booking |
| “Here is my customer file” | Prepare and import the customer records you authorize |
Creating or editing villas and rates requires an owner or admin role. Members retain the customer and booking operations allowed by their permissions.
In a terminal in the environment where your agent works, run:
npx skills add https://github.com/mikecodeur/skills --skill villaslotChoose your agent in the installer. Detailed guides are available for Claude Code, Codex, OpenClaw and Hermes. The agent documentation is in English.
If your agent runs on a server, install the skill on that server. Installing it on your computer does not automatically configure a remote environment.
Sign in to VillaSlot and open Account → API Keys. Create a key for the organization whose villas you want to manage.
Make the key available in your agent's environment as VILLASLOT_API_KEY. Also set the service address:
export VILLASLOT_BASE_URL="https://www.villaslot.io"Before requesting a change, check that the agent can access the right organization:
Use the villaslot skill and the API key from your environment.
Show my organization name and timezone, then list my active villas
with their priced durations. Do not change anything.This first request checks the context. The agent must use the organization's timezone for slots, even if your computer is in another country.
Provide an exact date, a duration and the venue:
Find a two-hour slot at Garden Villa on October 20, 2026, after 10:00
in the organization's timezone. Show availability and the price.
Wait for my choice before creating the booking.Once you choose a slot, ask the agent to find the customer or create their record, then state whether the booking should be provisional or confirmed. A provisional booking can already block the slot; it is more than a draft in a conversation.
The server checks availability again when creating the booking. If someone else books the slot in the meantime, the agent should offer another option instead of repeating the same attempt.
When changing a price, state what should be preserved:
Read Garden Villa's full rate grid. Prepare a two-hour rate of
1,500,000 IDR, preserve all other durations and show me the grid
before saving it.The API replaces the entire grid. Opening hours work the same way: omitting a day closes it. A precise instruction prevents a small edit from removing useful data.
The current API does not record manual payments, collect payments through Stripe, issue refunds or create overnight bookings. Confirming a booking does not make it paid. These operations remain in the relevant application workflows.
For an import, request a report of matched records and rejected rows. The agent should save created IDs to avoid duplicates after an interruption. There is no API parameter to disable emails: if the import must be silent, configure delivery settings in the application first.
Start with a task you know well: reading tomorrow's bookings or checking a villa's availability. Compare the result with your calendar, then gradually expand the operations you delegate to the agent.
The Agents guide brings together installation and connection examples. You keep the same villas, customers and rules; the agent becomes another way to work with your organization.