GeoLabel MCP Server
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:
{
"label": "Walmart",
"category": "supermarket",
"is_open": true,
"closes_at": "23:00",
"opening_hours": "Mo-Su 06:00-23:00"
}
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:
{
"mcpServers": {
"geolabel": {
"command": "uvx",
"args": ["geolabel-mcp"],
"env": {
"GEOLABEL_API_KEY": "glk_your_key_here"
}
}
}
}
Restart Claude Desktop. The GeoLabel tool will appear in the tools list.
Claude Code
claude mcp add geolabel -- uvx geolabel-mcp
export GEOLABEL_API_KEY=glk_your_key_here
Hermes Agent
Edit ~/.hermes/config.json:
{
"mcpServers": {
"geolabel": {
"command": "uvx",
"args": ["geolabel-mcp"],
"env": {
"GEOLABEL_API_KEY": "glk_your_key_here"
}
}
}
}
See Hermes Agent MCP docs for more.
OpenClaw
# Register the server
openclaw mcp set geolabel \
--command uvx \
--args geolabel-mcp \
--env GEOLABEL_API_KEY=glk_your_key_here
# Verify it's registered
openclaw mcp list
See OpenClaw MCP docs for more.
3. Use it
You: I'm at 41.8827, -87.6233 — what's here and is it open?
Agent: You're at Planet Fitness (a gym). It's currently open and closes
at 11:00 PM tonight — you have about 3 hours left.
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
# pip
pip install geolabel-mcp
# run directly
GEOLABEL_API_KEY=glk_xxx geolabel-mcp
Claude Code
claude mcp add geolabel -- uvx geolabel-mcp
Then set your key:
# add to your shell profile or .env
export GEOLABEL_API_KEY=glk_your_key_here
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) |
Privacy
GeoLabel strips coordinates from all server logs before they touch disk. No movement history is stored. Data is processed in real-time and immediately discarded. Full privacy policy →
License
MIT