Skip to main content
Glama
geolabel

geolabel-mcp

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

Install Server
A
license - permissive license
A
quality
C
maintenance

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