geolabel-mcp
Integrates with Hermes Agent to deliver real-time location labeling, including place names, categories, and opening hours via the GeoLabel API.
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_hereHermes 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 listSee 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 |
| float | required | Latitude (-90 to 90) |
| float | required | Longitude (-180 to 180) |
| int | 100 | Search radius in metres (max 500) |
Response fields:
Field | Type | Description |
| string | null | Raw venue name from OpenStreetMap |
| string | Clean, display-ready name |
| string | null | Stable type: |
| float | null | Distance from your coordinates to the place |
| bool | null |
|
| string | null | Next opening time |
| string | null | Today's closing time |
| string | null | Raw OSM |
| 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-mcpClaude Code
claude mcp add geolabel -- uvx geolabel-mcpThen set your key:
# add to your shell profile or .env
export GEOLABEL_API_KEY=glk_your_key_hereConfiguration
Variable | Required | Description |
| Yes | Your GeoLabel API key |
| No | Override API base URL (default: |
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
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/geolabel/geolabel-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server