📍 location-platform

Ask your AI assistant where you've been — and where you are right now.

Self-hosted MCP servers that turn your Google Maps Timeline and live location into tools for Claude, ChatGPT, or any MCP client.

Why

Google stopped offering Timeline on the web, and your location history now lives only on your phone (plus an encrypted cloud backup). This project pulls that history back out, keeps it on your own server, and lets an LLM answer questions about it — alongside a separate live feed for "where am I right now?".

Related MCP server: Google Workspace MCP Server

What you can ask

"Where was I last Tuesday around 3pm?" → where_was_i finds the visit or trip covering that moment.

"How much time did I spend at the gym in September?" → search_places + time_at_place totals every visit.

"Summarize my week." → summarize_week returns days, top places, distance, and how you got around.

"When was the last time I went to that taco place downtown?" → visit_history lists every visit, newest first.

"How far did I drive this month vs. walk?" → distance_traveled breaks it down by activity.

"Where am I right now, and have I moved since noon?" → where_am_i + movement_since from the live feed, with data age shown.

How it works

flowchart LR
    subgraph google["Google"]
        TB[(Timeline<br/>cloud backup)]
        LS[(Maps Location<br/>Sharing)]
    end

    subgraph server["Your server (Docker)"]
        TS[timeline-sync<br/><sub>Python · every 6 h</sub>]
        TJ[/Timeline.json/]
        TM[timeline-mcp<br/><sub>13 tools</sub>]
        LP[live poller<br/><sub>every 60 s</sub>]
        LD[(live.sqlite)]
        LM[live-location-mcp<br/><sub>5 tools</sub>]
        AUTH{{OAuth 2.1}}
    end

    TB --> TS --> TJ --> TM
    LS --> LP --> LD --> LM
    TM & LM --- AUTH
    AUTH --> C[Claude]
    AUTH --> G[ChatGPT]

History and live are deliberately two separate systems. Timeline is Google's semantic reconstruction (visits, trips, activities, Place IDs) and arrives hours late. Live Location Sharing is raw point observations, seconds old. They live in separate databases behind separate MCP servers and are never merged. The model picks the right tool, and every answer says how old its data is.

Features

Tools

Every tool is read-only and annotated as such. There is no SQL, file access, or bulk-export tool.

Quick start

Try it with synthetic data. No Google account needed.

git clone --recurse-submodules https://github.com/blakepennel/location-platform.git
cd location-platform
npm install
cd timeline-sync && python -m venv .venv && .venv/bin/pip install -e ".[dev]" && cd ..
cp .env.example .env

npm run seed   # invented Timeline + live observations
npm run dev    # OAuth :8700 · timeline-mcp :8701 · live-location-mcp :8702

Point an MCP client at http://localhost:8701/mcp or http://localhost:8702/mcp. It discovers the OAuth server and opens a sign-in page. For Claude Code, the stdio transport skips OAuth entirely; see DEVELOPMENT.md.

Running it for real (a home server, your own Google data):

docker compose up -d --build

DOCKER.md walks through the one-time Google steps, the noVNC browser logins, TPM setup for automatic re-auth, and connecting Claude and ChatGPT.

Project layout

location-platform/
├── timeline-sync/       Python · syncs + decrypts the Timeline backup (wraps arkenoi/timeline-export)
├── timeline-mcp/        TypeScript · historical MCP server over its own SQLite index
├── live-location-mcp/   TypeScript · live poller + MCP server
├── mcp-auth/            OAuth 2.1 resource-server verifier + local dev authorization server
├── shared/              logging/redaction, time/geo, sqlite, HTTP host
├── schemas/             export contract + status JSON schemas
├── tools/               dev runner, e2e harness, seed data, leak scanner, re-auth driver
└── docker/              container entrypoints (noVNC, sync loop, Google browser)

Testing

npm test           # 246 Node + ~125 Python tests
npm run test:e2e   # full stack: OAuth + both servers + a real MCP client
npm run leak-scan  # secrets and real-coordinate scan

Docs

Disclaimer

This is a personal project that reads your own data through undocumented Google endpoints: the Timeline cloud backup via arkenoi/timeline-export (a pinned submodule under its own MIT license), and Maps Location Sharing. Google can change or block them at any time, and using them may conflict with Google's Terms of Service. It is not affiliated with or endorsed by Google. Use it only with accounts you own, at your own risk.

License

MIT