Dawarich MCP

Minimal read-only MCP server for loading information from a Dawarich instance.

Tools

• dawarich_get_stats -> GET /api/v1/stats
• dawarich_get_timeline -> GET /api/v1/timeline
• dawarich_list_visits -> GET /api/v1/visits
• dawarich_list_points -> GET /api/v1/points
• dawarich_get_track_points -> GET /api/v1/tracks/:track_id/points
• dawarich_get_track_detail -> compact detail for one journey
• dawarich_export_track -> one journey as summary, JSON, GeoJSON, or CSV
• dawarich_reverse_geocode -> GPS coordinates to address via reverse geocoder
• dawarich_summarize_journeys -> simple from-to trip table for a date range

Setup

npm install
$env:DAWARICH_URL="https://your-dawarich.example.com"
$env:DAWARICH_API_KEY="replace-with-your-api-key"
npm start

By default the API key is sent as ?api_key=..., matching Dawarich docs. If your instance expects bearer auth, set:

$env:DAWARICH_AUTH_MODE="bearer"

Reverse geocoding defaults to OpenStreetMap Nominatim. For regular use, set a clear user agent:

$env:DAWARICH_GEOCODER_USER_AGENT="dawarich-mcp/0.3.0 contact=you@example.com"

You can also point it at another compatible reverse geocoder:

$env:DAWARICH_GEOCODER_URL="https://your-geocoder.example.com/reverse"

Example Prompts

Nacti detail cesty 12725 a rekni mi start, cil a kolik mela bodu.

Exportuj cestu 12725 jako GeoJSON.

Geolokuj souradnice 49.7281335, 13.3269319.

Vypis moje pracovni cesty za minuly tyden jako jednoduchou tabulku:
pondeli Chudenice -> Plzen, utery Chudenice -> Rybitvi.
Pouzij dawarich_summarize_journeys s weekdays_only=true, modes=["driving"] a include_markdown=true.

Add To Codex

From this folder:

codex mcp add dawarich `
  --env DAWARICH_URL="https://your-dawarich.example.com" `
  --env DAWARICH_API_KEY="replace-with-your-api-key" `
  -- node C:\Users\zilvar\Documents\Codex\2026-08-06\najd\outputs\dawarich-mcp\src\server.js

Then restart Codex or the ChatGPT desktop app. Use /mcp to confirm the server is connected.

Test With Inspector

npm run inspect

Notes

This server intentionally exposes read-only tools only. Add write tools, such as visit updates or merges, only after confirming the read flow works and you are comfortable letting an assistant modify location-history data.