Skip to main content
Glama

musicolet-mcp

Local tools for extracting listening metrics from Musicolet backup files, building a static dashboard, and exposing the same workflow through an optional MCP server.

This project is designed for power users who want their own music listening analytics without sending their library or listening history to a hosted service.

Features

  • Decode Musicolet backup ZIP files that contain encrypted app data.

  • Extract song, play-count, recent listening, artist, album, month, week, and year metrics.

  • Generate CSV files plus summary.json.

  • Build a static, local HTML dashboard.

  • Run as a CLI or optional MCP server for agent workflows.

Related MCP server: lastfm-mcp

Quick Start

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev,mcp]"

musicolet-mcp extract C:\path\to\musicolet_backup.zip --out-dir outputs\latest
musicolet-mcp dashboard outputs\latest --out outputs\latest\dashboard.html

Open outputs\latest\dashboard.html in a browser.

For a recurring Syncthing or USB drop folder:

musicolet-mcp update-latest data\incoming --out-dir outputs\latest

MCP Server

musicolet-mcp-server

Tools exposed by the server:

  • extract_musicolet_metrics

  • build_musicolet_dashboard

  • read_musicolet_summary

  • update_from_latest_musicolet_backup

Background

The extraction logic is based on local inspection of Musicolet backups. Backup internals are not an official public API and may change. The project aims to fail gracefully if a future Musicolet version changes its schema.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for rekordbox DJ database access. Provides read-only querying of tracks, playlists, and DJ session history from encrypted rekordbox SQLite databases using pyrekordbox.
      25
      135
      Python
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Unofficial, read-only access to your Last.fm listening history, charts, loved tracks, and artist, album and track lookups. Connect to https://lastfm-mcp.com/mcp and sign in with Last.fm. Not affiliated with Last.fm.
      53
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An intelligent MCP server that enables AI agents to act as sophisticated music curators for self-hosted Navidrome libraries, focusing on quality, discovery, and non-destructive management.
      15
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      A personal MCP server that analyzes your Spotify streaming history locally, enabling queries, artist insights, and recommendations using a local SQLite database.
      7
      MIT