# 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](https://apps.microsoft.com/detail/9PHH0491K006) · [Android on Google Play](https://play.google.com/store/apps/details?id=com.shaggai.mymusik) · [Linux AppImage](https://mymusik.app/en/download/) · [MyMusik website](https://mymusik.app/)

**Get the connector** · [Release downloads](https://github.com/shagg-ai/mymusik-mcp/releases/tag/v0.2.0) · [Official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.shagg-ai%2Fmymusik-mcp/versions/latest) · [Pair and find your first albums](#pair-and-find-your-first-albums)

<!-- mcp-name: io.github.shagg-ai/mymusik-mcp -->

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.

<p>
  <img src="https://raw.githubusercontent.com/shagg-ai/mymusik-mcp/main/docs/images/windows-albums.webp" width="70%" alt="MyMusik on Windows showing a grid of album covers with the track Moonlit Letters in the player">
  <img src="https://raw.githubusercontent.com/shagg-ai/mymusik-mcp/main/docs/images/android-queue.png" width="24.6%" alt="MyMusik on Android showing the Evening rotation 3 playback queue">
</p>

## 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.

| I want to… | What to say |
| --- | --- |
| **Play music** | “Play my Road Trip playlist.” |
| **Pause, resume or skip** | “Pause the music.” · “Keep playing.” · “Skip this song.” |
| **Choose what plays next** | “Let this song finish, then play my Friday rehearsal album.” |
| Find something to listen to | “Which albums by Paper Skies do I have? Show me the tracks on the first one.” |
| Make a playlist | “Make a playlist called Night Drive from the songs I’ve tagged Driving.” |
| Sort albums into folders | “In MyMusik, create a Live Sets folder with a subfolder for each artist. Sort my albums tagged Live into those folders.” |
| Add tags to several tracks | “Tag every song on Friday rehearsal as Practice. Keep the tags I already have.” |
| Fix artist names | “Show me the tracks credited to ‘PaperSkies’ so I can pick which ones to rename to ‘Paper Skies’.” |
| Import music | “Import the audio from my Rehearsals folder and tell me which files need review.” |
| Trim a recording | “Cut the first eight seconds of count-in from Friday rehearsal.” |
| Save a clip as a new track | “Save 01:12 to 01:42 from Friday rehearsal as a new track called Bridge Idea.” |
| Export a playlist | “Export Night Drive as an M3U8 playlist and make a ZIP of its MP3s.” |

**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](https://mymusik.app/en/music-mcp-server/)

## 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.

   ```sh
   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.

   ```sh
   mymusik-mcp pair
   ```

5. [Connect your MCP client](#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](https://mymusik.app/en/music-mcp-server/)

## Connect your MCP client

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

```sh
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.

```sh
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.

```sh
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](https://github.com/shagg-ai/mymusik-mcp/releases/download/v0.2.0/mymusik-mcp.mcpb) and open it in the client. For clients with an `mcpServers` configuration, use this configuration.

```json
{
  "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](https://github.com/shagg-ai/mymusik-mcp/blob/main/LICENSE) · [Release validation](https://github.com/shagg-ai/mymusik-mcp/blob/main/VALIDATION.md)