About Vetroscope
Vetroscope is an MCP server in the Science category: read-only Model Context Protocol server for Vetroscope — gives LLMs context on your tracked time, projects, and goals from your local Vetroscope SQLite database.
Install
claude mcp add vetroscope -- npx -y vetroscope-mcpnpx -y vetroscope-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (12)
get_app_breakdownPer-project breakdown for a single app over a period, with sub-projects.
Parameters not published.
get_app_statsDeep stats for one app: lifetime totals, days active, daily series, hour-of-day distribution, weekday distribution.
Parameters not published.
get_calendarDense per-day series (heatmap data) for any period — defaults to a full year.
Parameters not published.
get_category_breakdownTime rolled up into Vetroscope activity categories (`coding`, `creative`, `productivity`, `communication`, `entertainment`, `music`, `gaming`, `browsing`, `system`, `other`) — same taxonomy as Charts / Settings.
Parameters not published.
get_device_breakdownPer-device totals when you run Vetroscope across multiple machines.
Parameters not published.
get_focus_heatmap7×24 grid of active foreground seconds — when do you usually do specific kinds of work. Optional app / project / tag filter to narrow to a single activity; `include_descendants` rolls up a parent tag's subtree.
Parameters not published.
get_listening_historyTop tracks and top artists across native music apps and browser music sites, plus per-day listening minutes. Artists parsed from the "Artist — Title" sub_project convention.
Parameters not published.
get_media_linksCanonical deep-links Vetroscope captured for media you actually played — Spotify `spotify:track:…` URIs and YouTube `youtube.com/watch?v=…` URLs — joined with the matching time data. Requires Vetroscope ≥ 0.2.30 with `capture_media_links` enabled.
Parameters not published.
get_music_splitMusic-vs-work analysis: work-with-music / music-only / heads-down-work / other, plus per-source (Spotify, SoundCloud, …) overlap totals. Classifier is overridable per call.
Parameters not published.
get_reportAggregate report for a period — total active seconds, top apps, top projects with sub-projects nested (YouTube videos, SoundCloud songs, Netflix episodes).
Parameters not published.
get_tag_breakdownTime-spent report for a single tag — top apps, top projects, daily series, active/passive split. `include_descendants` rolls up a parent tag's subtree.
Parameters not published.
get_tag_statsDeep stats for one tag (counterpart to `get_app_stats`): lifetime totals, days active, daily series, hour-of-day and weekday distributions, plus the tag's parent and its children with rolled-up totals. Pass `include_descendants` to roll a parent tag's whole subtree into the series.
Parameters not published.
Ask AI
Ask AI about Vetroscope
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.