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:

config.json

{
  "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:

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

Terminal

claude mcp add geolabel -- uvx geolabel-mcp
export GEOLABEL_API_KEY=glk_your_key_here

Hermes Agent

Edit ~/.hermes/config.json:

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

bash

# 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

Code

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

bash

# pip
pip install geolabel-mcp

# run directly
GEOLABEL_API_KEY=glk_xxx geolabel-mcp

Claude Code

Terminal

claude mcp add geolabel -- uvx geolabel-mcp

Then set your key:

server.ts

# 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