[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [ClassPass nearby studios](https://spiral.ai/integrations/gemini-cli/classpass-nearby-studios)

# How to Use ClassPass nearby studios in Gemini CLI

Returns ClassPass venues near a location. Use it to shortlist places first, then inspect a studio's details or timetable.

|  |  |
| --- | --- |
| Model | ClassPass nearby studios |
| 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 ClassPass nearby studios in Gemini CLI

- Use ClassPass nearby studios to retrieve venues around Covent Garden, London, and build a comparison table from the returned studio records.
- Use ClassPass nearby studios to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from ClassPass nearby studios and tell me what changed since last week.
- Check ClassPass nearby studios and summarize what you find in three bullet points.
- Pull the newest data from ClassPass nearby studios and give me the result as a table.

## How to set up ClassPass nearby studios in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 ClassPass nearby studios**: 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": "classpass-com/fitness-classes/search_venues",
    "input": {
      "latitude": -90,
      "longitude": -180
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds ClassPass nearby studios on Spiral, shows the price and runs it.

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

## ClassPass nearby studios tools and prices

- [ClassPass · Search venues](https://spiral.ai/tools/alexandria/classpass-com/fitness-classes/search_venues) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| tag_ids |  | — | tag_ids |
| vertical | fitness, wellness, beauty | fitness | vertical |
| radius_km | 0.5 to 50 | 3 | radius_km |
| max_results | 1 to 200 | 50 | Trim the list to this many venues, in the site's order. |

## What can you do with ClassPass nearby studios in Gemini CLI?

Build a personal workout planner that moves from ClassPass city coverage to nearby studios and individual sessions. Use place coordinates, venue details, and timetables to organize choices around a trip or neighborhood.

### Plan workouts during a city trip

Check whether the destination has ClassPass coverage, locate the hotel neighborhood, shortlist studios, and inspect their timetables and individual sessions to find workouts between travel plans.

### Find a workout near a conference

Confirm the host city's coverage, center discovery on the conference venue, and compare nearby studios and session times against the event agenda.

### Choose a studio after moving

Check the destination market, locate the new neighborhood, and compare listed studios, class types, daily timetables, and specific sessions before choosing where to try a workout.

### Keep a workout routine while traveling

Check coverage in each destination, locate the areas you will visit, and find studios and sessions that match your preferred activity and available hours.

### Find an alternative when plans change

Search around a public landmark for another class, inspect nearby studios, and check a selected session before changing your workout plan.

## Overview

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

## ClassPass nearby studios in other agents

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

## More Gemini CLI guides

- [ClassPass nearby classes](https://spiral.ai/integrations/gemini-cli/classpass-nearby-classes)
- [ClassPass studio details](https://spiral.ai/integrations/gemini-cli/classpass-studio-details)
- [ClassPass location lookup](https://spiral.ai/integrations/gemini-cli/classpass-location-lookup)
- [ClassPass studio timetable](https://spiral.ai/integrations/gemini-cli/classpass-studio-timetable)
- [ClassPass class session details](https://spiral.ai/integrations/gemini-cli/classpass-class-session-details)
- [ClassPass supported cities](https://spiral.ai/integrations/gemini-cli/classpass-supported-cities)

## Questions about ClassPass nearby studios in Gemini CLI

**Can Gemini CLI use ClassPass nearby studios?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run ClassPass nearby studios like any built-in tool.

**How much does ClassPass nearby studios cost in Gemini CLI?**

$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 CLI plan is separate.

**Do I need an Alexandria account to use ClassPass nearby studios in Gemini CLI?**

No. Spiral runs ClassPass nearby studios on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up ClassPass nearby studios in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while ClassPass nearby studios runs?**

ClassPass nearby studios runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**How broad is ClassPass coverage?**

ClassPass reported more than 88,000 listed businesses in 643 cities and 31 countries as of January 2026. That describes its platform footprint, not the number of studios or sessions returned by a search.

**Does ClassPass include every class a studio offers?**

No. Some studios reserve certain classes for their direct customers, so a ClassPass timetable can omit sessions offered elsewhere by the studio.

**Why can a class appear after an earlier search found nothing?**

ClassPass says a cancellation can reopen a spot. Its Fitness Classes search shows sessions with open spots, so an absent result does not establish that the studio has no scheduled class.

**How far ahead do reservations usually open?**

For most businesses, reservations open at noon local time one week before the session date. This booking window does not establish an endpoint's maximum search horizon.

**What session information is publicly visible?**

Public ClassPass studio pages can show a daily timetable with class names, start times, UTC offsets, and durations. GROUNDUP Studio's public page provides an example.

