[Integrations](https://spiral.ai/integrations) › [Gemini](https://spiral.ai/integrations/gemini) › [Resy reservation calendar](https://spiral.ai/integrations/gemini/resy-reservation-calendar)

# How to Use Resy reservation calendar in Gemini

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.

|  |  |
| --- | --- |
| Model | Resy reservation calendar |
| Available through | Alexandria |
| Category | Maps & Reviews |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Resy reservation calendar in Gemini

- Use Resy reservation calendar to find which dates Carbone in New York has openings for two people over the next two weeks.
- Use Resy reservation calendar to look this up and give me the result as a table.
- 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 Gemini

Pick the way that suits you. Each takes about two minutes.

### Use the Gemini connector

1. **Open Connected Apps**: On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.

2. **Add Spiral as a custom app**: Under Custom apps, click Add a custom app and paste this MCP server URL:

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.

### Use the Spiral skill

1. **Send Gemini this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Resy reservation calendar**: One request; the result comes back by polling or a webhook.

```bash
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: Gemini finds Resy reservation calendar on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini

## Resy reservation calendar tools and prices

- [Resy · Calendar](https://spiral.ai/tools/alexandria/resy-com/restaurants/calendar) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| 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). |

## What can you do with Resy reservation calendar in Gemini?

Turn a dinner request into restaurant choices with useful locations, dates, seatings, and reservation requirements. A chat app can explain Resy's returned information in plain language while you decide where and when to eat.

### 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.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini guides](https://spiral.ai/integrations/gemini)

## Resy reservation calendar in other agents

- [Amp](https://spiral.ai/integrations/amp/resy-reservation-calendar)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/resy-reservation-calendar)
- [Claude](https://spiral.ai/integrations/claude-desktop/resy-reservation-calendar)
- [Claude Code](https://spiral.ai/integrations/claude-code/resy-reservation-calendar)
- [Cline](https://spiral.ai/integrations/cline/resy-reservation-calendar)
- [Codex](https://spiral.ai/integrations/codex/resy-reservation-calendar)
- [Cursor](https://spiral.ai/integrations/cursor/resy-reservation-calendar)
- [Devin](https://spiral.ai/integrations/devin/resy-reservation-calendar)
- [dots](https://spiral.ai/integrations/dots/resy-reservation-calendar)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/resy-reservation-calendar)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/resy-reservation-calendar)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/resy-reservation-calendar)
- [goose](https://spiral.ai/integrations/goose/resy-reservation-calendar)
- [Grok](https://spiral.ai/integrations/grok/resy-reservation-calendar)
- [Grok Build](https://spiral.ai/integrations/grok-build/resy-reservation-calendar)
- [Hermes](https://spiral.ai/integrations/hermes/resy-reservation-calendar)
- [Instinct](https://spiral.ai/integrations/instinct/resy-reservation-calendar)
- [Manus](https://spiral.ai/integrations/manus/resy-reservation-calendar)
- [Muse](https://spiral.ai/integrations/muse/resy-reservation-calendar)
- [Muse Code](https://spiral.ai/integrations/muse-code/resy-reservation-calendar)
- [n8n](https://spiral.ai/integrations/n8n/resy-reservation-calendar)
- [Notion](https://spiral.ai/integrations/notion/resy-reservation-calendar)
- [OpenClaw](https://spiral.ai/integrations/openclaw/resy-reservation-calendar)
- [opencode](https://spiral.ai/integrations/opencode/resy-reservation-calendar)
- [Perplexity](https://spiral.ai/integrations/perplexity/resy-reservation-calendar)
- [Raycast](https://spiral.ai/integrations/raycast/resy-reservation-calendar)
- [VS Code](https://spiral.ai/integrations/vscode/resy-reservation-calendar)
- [Windsurf](https://spiral.ai/integrations/windsurf/resy-reservation-calendar)
- [Zapier](https://spiral.ai/integrations/zapier/resy-reservation-calendar)

## More Gemini guides

- [Resy city lookup](https://spiral.ai/integrations/gemini/resy-city-lookup)
- [Resy reservation conditions](https://spiral.ai/integrations/gemini/resy-reservation-conditions)
- [Resident Advisor venue profile](https://spiral.ai/integrations/gemini/resident-advisor-venue-profile)
- [Resy restaurant details](https://spiral.ai/integrations/gemini/resy-restaurant-details)
- [Resident Advisor search](https://spiral.ai/integrations/gemini/resident-advisor-search)
- [Resy restaurant search](https://spiral.ai/integrations/gemini/resy-restaurant-search)

## Questions about Resy reservation calendar in Gemini

**Can Gemini use Resy reservation calendar?**

Yes. Add Spiral to Gemini as an MCP server, and Gemini can find and run Resy reservation calendar like any built-in tool.

**How much does Resy reservation calendar cost in Gemini?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini plan is separate.

**Do I need an Alexandria account to use Resy reservation calendar in Gemini?**

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 Gemini?**

About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.

**Does Gemini wait while Resy reservation calendar runs?**

Resy reservation calendar runs in the background. Gemini 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.

