geo-tracker
Geospatial tracking MCP server — checkpoints, path tracking, phone GPS ingestion, geo-fencing, routing. Uses OpenStreetMap/OSRM (free, no API key).
SKILL.mdskills/productivity/geo-tracker/SKILL.md
GitHubGeo Tracker (Geospatial MCP Server)
Real-time geospatial tracking for Hermes agents. Combines OpenStreetMap geocoding/routing with checkpoint memory and phone GPS ingestion.
How Phone GPS Works
The MCP server runs an HTTP endpoint on port 8484 for OwnTracks GPS data:
- Install OwnTracks (FOSS, Android/iOS) on your phone
- Configure it to POST to
http://YOUR_VPS_IP:8484/location - Phone's GPS is stored in SQLite and available via MCP tools
Alternatively, just tell me "I'm at the park" and I'll geocode it.
MCP Tools
Checkpoints (Memory)
checkpoint_set(name, lat, lon)— "I parked the car here"checkpoint_get(name)— recall saved locationcheckpoint_list()— see all checkpointscheckpoint_delete(name)— remove one
Path Tracking
track_start(name, lat, lon)— start recording a pathtrack_point(name, lat, lon)— add a waypointtrack_end(name)— finish and get distance/duration/speedtrack_summary(name)— stats without ending
Phone Location
phone_location_set(lat, lon)— manual GPS updatephone_location_get()— latest phone position + addressphone_location_history(limit)— recent GPS trailwhere_is_my_phone(from_checkpoint?)— phone address + distance from checkpoint
Distance & Routing
distance_between(from, to, mode)— road distance + timedistance_from_checkpoint(checkpoint, to_lat, to_lon)— how far from saved pointgeocode(query)— place name → coordinatesreverse_geocode(lat, lon)— coordinates → address
Geo-Fencing
geo_fence_create(name, center_lat, center_lon, radius_m)— define a fencegeo_fence_check()— phone inside/outside each fence?geo_fence_list()— all defined fences
Server Path
~/.hermes/skills/productivity/geo-tracker/scripts/geo_tracker_server.py
Dependencies
- Python 3.8+ stdlib (no pip installs needed)
mcppackage (for MCP protocol)