geolabel/geolabel-mcp

Turn GPS coordinates into AI-ready location context — for Claude Desktop, Claude Code, and any MCP-compatible assistant.
What it does
Send coordinates. Get back a place name, category, and real-time opening hours:
Claude can then answer: *"You're at Walmart, which closes in 47 minutes."*
---
Quick setup
1. Get a GeoLabel API key
Free at geolabel.dev — 100 requests/day, no credit card required.
2. Add to your agent
Pick your client below.
---
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
Restart Claude Desktop. The GeoLabel tool will appear in the tools list.
Claude Code
Hermes Agent
Edit ~/.hermes/config.json:
See Hermes Agent MCP docs for more.
OpenClaw
See OpenClaw MCP docs for more.
---
3. Use it
---
Tools
get_location_label
Identifies the nearest named place within radius metres of the given coordinates.
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| lat | float | required | Latitude (-90 to 90) |
| lng | float | required | Longitude (-180 to 180) |
| radius | int | 100 | Search radius in metres (max 500) |
**Response fields:**
| Field | Type | Description |
|-------|------|-------------|
| place | string \| null | Raw venue name from OpenStreetMap |
| label | string | Clean, display-ready name |
| category | string \| null | Stable type: gym, supermarket, restaurant, etc. |
| distance_meters | float \| null | Distance from your coordinates to the place |
| is_open | bool \| null | true open · false closed · null no hours data |
| opens_at | string \| null | Next opening time HH:MM (when closed) |
| closes_at | string \| null | Today's closing time HH:MM (when open) |
| opening_hours | string \| null | Raw OSM opening_hours string |
| cached | bool | Served from 10-min cache; hours always recalculated live |
---
Alternative installation
Claude Code
Then set your key:
---
Configuration
| Variable | Required | Description |
|----------|----------|-------------|
| GEOLABEL_API_KEY | Yes | Your GeoLabel API key |
| GEOLABEL_BASE_URL | No | Override API base URL (default: https://api.geolabel.dev) |