How to Use Resy reservation calendar in Claude Code
Returns daily reservation status across a restaurant's booking calendar. Use it to find dates with openings and distinguish available, sold-out, and closed days before checking exact times.
Prompts to try with Resy reservation calendar in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use Resy reservation calendar for Lilia for two guests over the next two weeks and display the returned daily statuses in this project's calendar.
Use Resy reservation calendar to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Resy reservation calendar and tell me what changed since last week.
Check Resy reservation calendar and summarize what you find in three bullet points.
Pull the newest data from Resy reservation calendar and give me the result as a table.
How to set up Resy reservation calendar in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Resy reservation calendar
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "resy-com/restaurants/calendar", "input": { "venue_id": 1 } }'
Then paste one of the prompts above: Claude Code finds Resy reservation calendar on Spiral, shows the price and runs it.
Resy reservation calendar providers and prices
Spiral runs Resy reservation calendar through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Venue ID | a number from 1 | Resy venue id ( | |
| Days | 1 to 366 | Range length from start_date when end_date is omitted (default 30). | |
| Party size | 1 to 20 | Number of guests (default 2). |
Every API field of Resy · Calendar is on its tool page: open its card above.
What can you do with Resy reservation calendar in Claude Code?
Build a dining planner that connects Resy city records, restaurant profiles, calendar openings, and available seatings. A coding agent can bring returned data into your project and display reservation conditions beside each choice.
Plan dinners for a city break
Identify Chicago's Resy location, discover restaurants, and compare their profiles. Check calendars across the trip, inspect exact times on promising dates, and review the selected reservation's conditions.
Find a birthday dinner with date flexibility
Locate the New York dining market and find restaurants for six guests. Compare venue details, calendars, open times, and reservation requirements across several possible evenings.
Choose dinner before a show
Resolve the destination city and find restaurants near the theater. Use venue addresses, calendar openings, exact seating times, and reservation conditions to choose dinner for the performance date or an alternate night.
Build a shortlist around preferred seating
Start with San Francisco's Resy location and discover candidate restaurants. Read their profiles, find dates with openings, compare returned seating labels, and inspect the conditions for a suitable reservation.
Compare a favorite restaurant across several evenings
Read a restaurant's profile and calendar, then compare exact openings on the available dates. Review the conditions for the seating that best fits the dinner plan.
More on Resy reservation calendar and Claude Code
Overview
Resy reservation calendar in other agents
Questions about Resy reservation calendar in Claude Code
Can Claude Code use Resy reservation calendar?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Resy reservation calendar like any built-in tool.
How much does Resy reservation calendar cost in Claude Code?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.
Do I need an Alexandria account to use Resy reservation calendar in Claude Code?
No. Spiral runs Resy reservation calendar on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up Resy reservation calendar in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Resy reservation calendar runs?
Resy reservation calendar runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.
What kinds of venues does Resy cover?
Resy announced a discovery catalog of more than 25,000 venues after adding Tock listings. Its coverage includes restaurants, wineries, and culinary experiences.
Does no online availability mean a restaurant is full?
No. Restaurants can hold tables back for walk-ins or in-house bookings, so Resy's online inventory does not represent every seat in the restaurant.
How far ahead are reservations published?
The booking window varies by restaurant. Resy's November 2026 guide lists Lilia at 28 days ahead at 10 a.m. and Straker's NYC at two weeks ahead at midnight.
How quickly can availability change?
Resy warns that inventory can change quickly. An opening returned during a search can disappear before you finish choosing a restaurant.
Are reservation requirements the same at every restaurant?
No. Individual reservations can carry cancellation policies or prepayment requirements, so the conditions attached to the selected seating matter.
Start using Resy reservation calendar in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


