musicolet-mcp
Allows processing and updating listening metrics from Musicolet backup files that are synchronized via Syncthing, by monitoring a Syncthing drop folder for new backups.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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.htmlOpen outputs\latest\dashboard.html in a browser.
For a recurring Syncthing or USB drop folder:
musicolet-mcp update-latest data\incoming --out-dir outputs\latestMCP Server
musicolet-mcp-serverTools exposed by the server:
extract_musicolet_metricsbuild_musicolet_dashboardread_musicolet_summaryupdate_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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Syslog receiver and MCP server for homelab log intelligence.
Syslog receiver and MCP server for homelab log intelligence.
Remote MCP server for audio stem separation, denoise, reverb, and MIDI export.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for rekordbox DJ database access. Provides read-only querying of tracks, playlists, and DJ session history from encrypted rekordbox SQLite databases using pyrekordbox.25135PythonMIT
- AlicenseNot gradedqualityBmaintenanceUnofficial, 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.53MIT
- AlicenseAqualityDmaintenanceAn 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.151MIT
- AlicenseAqualityCmaintenanceA personal MCP server that analyzes your Spotify streaming history locally, enabling queries, artist insights, and recommendations using a local SQLite database.7MIT