MyMusik MCP

Ask Claude, Codex or another MCP client to play music from your own library. Try “Play my Road Trip playlist.” The music plays in MyMusik, and you can pause, skip or pick the next album from the same chat. You can also import recordings, cut clips and organize your collection.

The connector runs on the computer that runs your MCP client. It talks to your open MyMusik app on the same computer or over your private network. You choose what it can do and when its access expires.

Get MyMusik · Windows on the Microsoft Store · Android on Google Play · Linux AppImage · MyMusik website

Get the connector · Release downloads · Official MCP Registry · Pair and find your first albums

MyMusik is an offline music player and library manager for the files you own. Import your MP3, FLAC and WAV files, browse by album or artist, and keep separate queues for different listening sessions. Local playback is free and works without an account.

What you can ask

Choose Remote playback when you pair to try the first three rows. Version 0.2.0 adds a direct tool for pausing, resuming and skipping in the current queue. Use the name of a song, album or playlist from your own library.

Choose what your assistant can change. Use Read only to browse, Remote playback to listen, Library editor for playlists, folders, tags and track details, or Import manager for imports and audio edits. To save a clip as a new library track, choose Custom and allow writes to both Imports and files and Music library. Imports need a source MyMusik can read, cuts need editable local audio, and downloads need a client that can save files.

To switch access on an existing connection, apply the new permissions in MyMusik, copy a fresh invitation, run mymusik-mcp pair again and reconnect your client. Illustrated permissions guide

Related MCP server: Apple Music MCP

Pair and find your first albums

1. Install MyMusik, add some music and keep the app running. If the app is on a different device, put both devices on the same private network and enable Allow Remote Access in MyMusik’s web server settings.

2. On the computer running your MCP client, install Python 3.10 or newer and run the following command. If you use a virtual environment, activate it first.

   python -m pip install https://github.com/shagg-ai/mymusik-mcp/releases/download/v0.2.0/mymusik_mcp-0.2.0-py3-none-any.whl

3. In MyMusik, open Insights → Connect a device. Select the shield, choose Read only to browse or Remote playback to play music, pick a session duration, then Apply → Copy agent prompt.

4. Run the pairing command below. At the hidden input, paste only the invitation URL containing #grant= from the copied prompt and press Enter. Each invitation works once.

   mymusik-mcp pair

5. Connect your MCP client, then ask “List three albums from my MyMusik library.” Open Albums in MyMusik to compare the names. With Remote playback, follow up with “Play the first one.”

When access expires, copy a fresh invitation, run mymusik-mcp pair again and reconnect or restart the server in your client. Illustrated pairing guide

Connect your MCP client

Codex. With the installed mymusik-mcp executable on your PATH, run these commands and start a new local chat.

codex plugin marketplace add shagg-ai/mymusik-mcp
codex plugin add mymusik@mymusik-plugins

Gemini CLI. After pairing, install the extension from the repository and start a new Gemini CLI session. The extension runs the bundled connector with python on your PATH.

gemini extensions install https://github.com/shagg-ai/mymusik-mcp --ref=main

Claude Code. Clone this repository and start a local session with the bundled plugin. It uses python on your PATH and reads the session you paired above.

git clone https://github.com/shagg-ai/mymusik-mcp.git
cd mymusik-mcp
claude --plugin-dir ./plugins/mymusik

Other local MCP clients. If your client accepts MCP bundles, download the MCPB and open it in the client. For clients with an mcpServers configuration, use this configuration.

{
  "mcpServers": {
    "mymusik": {
      "command": "mymusik-mcp",
      "args": ["stdio"]
    }
  }
}

If a desktop client cannot find the command, use the absolute path to the installed executable. For Codex, launch it from the activated environment or install the downloaded wheel with pipx, add the pipx applications directory to PATH and restart Codex. The command also defaults to stdio when called without arguments.

Permissions and stored data

Pair under the operating-system account that runs your client. The connector saves the session in %LOCALAPPDATA%/mymusik-mcp/connection.profile on Windows using user-scoped DPAPI. On other systems it uses a private file with mode 0600 under $XDG_CONFIG_HOME/mymusik-mcp or ~/.config/mymusik-mcp. Delete the profile to remove the saved session. Keep invitations and profiles private. Your selected MCP client receives the tool results.

To pair a second instance, pass the same --profile PATH to both mymusik-mcp pair and mymusik-mcp stdio. From a source checkout, you can also pair with python plugins/mymusik/mymusik_mcp/cli.py pair.

MIT license · Release validation