How do I install the Owntracks Location skill?

Run npx skillmds@latest add dvcrn/owntracks-location in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Owntracks Location safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Owntracks Location?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Owntracks Location free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Owntracks Location?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Owntracks Location by dvcrn — Agent Skill

Name: Owntracks Location
Rating: 4.2 (5 reviews)
Author: dvcrn

Owntracks Location

Real-time phone location tracking via OwnTracks HTTP webhook receiver with named places and distance-based queries. Use when: (1) user asks "where am I?", (2) storing named locations (home, gym, work), (3) querying nearby places by distance, (4) checking location history. Requires: OwnTracks app on phone, Tailscale or LAN connectivity, Node.js 22+, better-sqlite3.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

OwnTracks Location

Real-time location awareness via OwnTracks → HTTP webhook → SQLite.

Architecture

Phone (OwnTracks) → HTTP POST → server.mjs (port 18793) → SQLite + latest.json
Agent queries → places.mjs CLI or curl http://localhost:18793/latest

Setup

1. Start the receiver

node scripts/server.mjs
# Default port: 18793. Override: OWNTRACKS_PORT=9999
# Data dir override: OWNTRACKS_DATA=/path/to/data

Recommended: install as user systemd service for persistence.

mkdir -p ~/.config/systemd/user
cat << 'EOF' > ~/.config/systemd/user/owntracks-receiver.service
[Unit]
Description=OwnTracks Location Receiver
After=network.target

[Service]
Type=simple
Environment=OWNTRACKS_PORT=18793
Environment=OWNTRACKS_DATA=<SKILL_DIR>/scripts/data
ExecStart=/usr/local/bin/node <SKILL_DIR>/scripts/server.mjs
Restart=always
RestartSec=5

[Install]
WantedBy=default.target
EOF
systemctl --user daemon-reload
systemctl --user enable --now owntracks-receiver

Replace <SKILL_DIR> with the absolute path to this skill directory.

2. Configure OwnTracks on phone

Install OwnTracks from F-Droid or Play Store
Open → Menu → Preferences → Mode → HTTP
URL: http://<host-tailscale-ip>:18793/owntracks
Tap 📤 on the map to send a test ping

Phone must reach the receiver (same LAN or Tailscale).

3. Verify

curl http://localhost:18793/latest
# Should return JSON with lat, lon, acc, batt, etc.

Places CLI

Named locations with haversine distance queries.

# Add a place
node scripts/places.mjs add "Home" 41.3200 1.8900 home "Olivella"
node scripts/places.mjs add "Gym" 41.2229 1.7385 gym "Aqua Sport, Vilanova"

# Where am I? (reads OwnTracks latest + finds nearest named place)
node scripts/places.mjs where

# Find nearby places from arbitrary coordinates
node scripts/places.mjs nearest 41.22 1.74 5 500

# Search by name/category/notes
node scripts/places.mjs search "gym"

# List all
node scripts/places.mjs list
node scripts/places.mjs list gym

# Remove
node scripts/places.mjs remove "Old Place"

Agent Usage

When user asks "where am I?":

curl -s http://localhost:18793/latest
node scripts/places.mjs where

When user says "this is my X" at a location:

Get current coords from /latest
Reverse geocode via Nominatim or web search for the business name
node scripts/places.mjs add "<name>" <lat> <lon> <category>

Server Endpoints

Method	Path	Description
POST	`/owntracks`	OwnTracks webhook (expects `_type: "location"`)
GET	`/latest`	Last known location
GET	`/history?limit=50`	Location history
GET	`/health`	Health check

Dependencies

Node.js 22+
better-sqlite3 (for places.mjs)
OwnTracks app (Android/iOS)
Network path from phone to receiver (Tailscale recommended)

---name: owntracks-locationdescription: Real-time phone location tracking via OwnTracks HTTP webhook receiver with named places and distance-based queries. Use when: (1) user asks "where am I?", (2) storing named locations (home, gym, work), (3) querying nearby places by distance, (4) checking location history. Requires: OwnTracks app on phone, Tailscale or LAN connectivity, Node.js 22+, better-sqlite3.---# OwnTracks LocationReal-time location awareness via OwnTracks → HTTP webhook → SQLite.## Architecture```Phone (OwnTracks) → HTTP POST → server.mjs (port 18793) → SQLite + latest.jsonAgent queries → places.mjs CLI or curl http://localhost:18793/latest```## Setup### 1. Start the receiver```bashnode scripts/server.mjs# Default port: 18793. Override: OWNTRACKS_PORT=9999# Data dir override: OWNTRACKS_DATA=/path/to/data```Recommended: install as user systemd service for persistence.```bashmkdir -p ~/.config/systemd/usercat << 'EOF' > ~/.config/systemd/user/owntracks-receiver.service[Unit]Description=OwnTracks Location ReceiverAfter=network.target[Service]Type=simpleEnvironment=OWNTRACKS_PORT=18793Environment=OWNTRACKS_DATA=<SKILL_DIR>/scripts/dataExecStart=/usr/local/bin/node <SKILL_DIR>/scripts/server.mjsRestart=alwaysRestartSec=5[Install]WantedBy=default.targetEOFsystemctl --user daemon-reloadsystemctl --user enable --now owntracks-receiver```Replace `<SKILL_DIR>` with the absolute path to this skill directory.### 2. Configure OwnTracks on phone1. Install OwnTracks from F-Droid or Play Store2. Open → Menu → Preferences → Mode → **HTTP**3. URL: `http://<host-tailscale-ip>:18793/owntracks`4. Tap 📤 on the map to send a test pingPhone must reach the receiver (same LAN or Tailscale).### 3. Verify```bashcurl http://localhost:18793/latest# Should return JSON with lat, lon, acc, batt, etc.```## Places CLINamed locations with haversine distance queries.```bash# Add a placenode scripts/places.mjs add "Home" 41.3200 1.8900 home "Olivella"node scripts/places.mjs add "Gym" 41.2229 1.7385 gym "Aqua Sport, Vilanova"# Where am I? (reads OwnTracks latest + finds nearest named place)node scripts/places.mjs where# Find nearby places from arbitrary coordinatesnode scripts/places.mjs nearest 41.22 1.74 5 500# Search by name/category/notesnode scripts/places.mjs search "gym"# List allnode scripts/places.mjs listnode scripts/places.mjs list gym# Removenode scripts/places.mjs remove "Old Place"```## Agent UsageWhen user asks "where am I?":```bashcurl -s http://localhost:18793/latestnode scripts/places.mjs where```When user says "this is my X" at a location:1. Get current coords from `/latest`2. Reverse geocode via Nominatim or web search for the business name3. `node scripts/places.mjs add "<name>" <lat> <lon> <category>`## Server Endpoints| Method | Path | Description ||--------|------|-------------|| POST | `/owntracks` | OwnTracks webhook (expects `_type: "location"`) || GET | `/latest` | Last known location || GET | `/history?limit=50` | Location history || GET | `/health` | Health check |## Dependencies- Node.js 22+- `better-sqlite3` (for places.mjs)- OwnTracks app (Android/iOS)- Network path from phone to receiver (Tailscale recommended)

Frequently asked questions