Send GPS coordinates. Get back a place name and a stable category — gym, grocery, gas_station — that your Apple Shortcuts, Python scripts, and apps can act on instantly.
Query params are stripped from all server logs before they touch disk.
In-memory only, purged every 10 minutes. No movement history stored.
Powered by OpenStreetMap. No Google Maps, no expensive licensing.
Your location data is processed in real-time and immediately discarded.
No SDKs to install. No accounts to create for basic use. One GET request with your coordinates returns everything your automation needs.
Pass lat and lng as query parameters with your API key in the header. That's the entire integration.
GeoLabel searches the world's largest open map database for the nearest named place. Results are cached for 10 minutes so repeated lookups are instant.
categorycategory: "gym" fires whether you're at Planet Fitness, Equinox, YMCA, or any other gym on Earth. Build the logic once; it works everywhere.
Each recipe uses category so it works at any location of that type — not just one specific venue.
Walk into any gym. Your phone switches into workout mode before you touch the floor.
Walk into any grocery store. Your list opens automatically — Walmart, Whole Foods, your local market.
Pull into any gas station. Your rewards app opens so you never forget to scan.
Sit down at any restaurant. The name and date get logged automatically.
Full step-by-step Apple Shortcuts instructions → Shortcut Library →
One HTTP request is all it takes. Use whatever language or tool you already have.
# Get a free key at geolabel.dev, then: curl "https://api.geolabel.dev/label?lat=41.8827&lng=-87.6233" \ -H "X-API-Key: your_key_here"
import httpx result = httpx.get( "https://api.geolabel.dev/label", headers={"X-API-Key": "your_key_here"}, params={"lat": 41.8827, "lng": -87.6233}, ).json() print(result["category"]) # → "gym" print(result["label"]) # → "Planet Fitness" if result["category"] == "gym": start_workout_mode() elif result["category"] == "grocery": open_shopping_list()
const res = await fetch( "https://api.geolabel.dev/label?lat=41.8827&lng=-87.6233", { headers: { "X-API-Key": "your_key_here" } } ); const { category, label } = await res.json(); const actions = { gym: () => startWorkoutMode(), grocery: () => openShoppingList(), gas_station: () => openRewardsApp(), }; actions[category]?.();
let url = URL(string: "https://api.geolabel.dev/label?lat=41.8827&lng=-87.6233")! var request = URLRequest(url: url) request.setValue("your_key_here", forHTTPHeaderField: "X-API-Key") let (data, _) = try await URLSession.shared.data(for: request) let result = try JSONDecoder().decode(GeoLabelResponse.self, from: data) switch result.category { case "gym": startWorkoutMode() case "grocery": openShoppingList() default: break }
One package. Any MCP client — Claude, Hermes Agent, or OpenClaw — can call GeoLabel directly. No Shortcuts, no copy-pasting coordinates.
Generate your key — 10 seconds, no credit card.
Pick your client from the tabs, paste the config, and drop in your key. One-time setup.
Your agent calls GeoLabel, gets the label, category, and live hours, and responds naturally.
── claude_desktop_config.json ─────────── { "mcpServers": { "geolabel": { "command": "uvx", "args": ["geolabel-mcp"], "env": { "GEOLABEL_API_KEY": "glk_your_key_here" } } } } ── Claude Code (one-liner) ────────────── claude mcp add geolabel -- uvx geolabel-mcp ── Result ─────────────────────────────── You: I'm at 41.8827, -87.6233 — what's here? Claude: Planet Fitness (gym) · open · closes 23:00
── ~/.hermes/config.json ──────────────── { "mcpServers": { "geolabel": { "command": "uvx", "args": ["geolabel-mcp"], "env": { "GEOLABEL_API_KEY": "glk_your_key_here" } } } } ── Result ─────────────────────────────── You: I'm at 41.8827, -87.6233 — what's here? Hermes: Planet Fitness (gym) · open · closes 23:00
── Register via CLI ───────────────────── openclaw mcp set geolabel \ --command uvx \ --args geolabel-mcp \ --env GEOLABEL_API_KEY=glk_your_key_here ── Verify ─────────────────────────────── openclaw mcp list ── Result ─────────────────────────────── You: I'm at 41.8827, -87.6233 — what's here? OpenClaw: Planet Fitness (gym) · open · closes 23:00
No credit card required for the free tier. Upgrade anytime.
≈ $7.50/mo · 2 months free
≈ $24/mo · 2 months free
≈ $66/mo · 2 months free