About geolabel/geolabel-mcp
geolabel/geolabel-mcp is an MCP server in the Maps category: returns place name, stable category (gym, supermarket, restaurant…), and live opening hours via OpenStreetMap. Works in Claude Desktop, Claude Code, Hermes Agent, OpenClaw, and any MCP client.
Install
git clone https://github.com/geolabel/geolabel-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about geolabel/geolabel-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.