PlugWiki
nuclear logo

Nuclear Music Player MCP Server: Setup for Claude, Cursor and Other Apps

OfficialRemote
Getnukeop/nuclear
Tools
4
3 read · 1 change
Works in
12
apps
Risk
High
can delete
Auth
None

Lets Claude, Codex and other assistants control the Nuclear music player: search music, build the queue, play tracks and manage playlists.

Nuclear is a free desktop music player, and its MCP server is built into the app. You switch it on in Settings, then Integrations, and your assistant connects to it on your own computer. There is no account or API key. The assistant reaches the player through four tools that let it look up and then run methods for playback, the queue, search, playlists and more.

Good for

  • Nuclear users who want to say what they want to hear and have the queue built
  • People who want an assistant to make and organize playlists and favorites
  • Plugin developers testing the player's API from their assistant

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install nuclear MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the nuclear MCP server to Claude Code. Run this command:

claude mcp add nuclear --transport http http://127.0.0.1:8800/mcp

Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Nuclear running, MCP Server switched on in Settings.

From the vendor's docs. Source.

Tools

  • Lists what you can do in one area of Nuclear

    Lists the methods in one area of the player, such as Queue, Playback, Metadata, Favorites, Playlists, Dashboard, Providers, Lyrics, Navigation or Views, with a short description of each.

    Try: “What can you do with the queue in Nuclear?”

    Read · list_methods

  • Shows how one method works

    Returns one method's description, its parameters and its return type, for a method written like Queue.addToQueue.

    Try: “Show the details of Queue.addToQueue.”

    Read · method_details

  • Shows the shape of a data type

    Returns the fields of a type such as Track, QueueItem or Playlist, for when a method refers to one.

    Try: “What does a Track contain?”

    Read · describe_type

  • Runs a Nuclear method

    Runs the method you name with the parameters you give it. Through it the assistant can play, pause and seek, edit the queue, search music and metadata, manage favorites and playlists (including deleting them), fetch lyrics, change settings and add temporary pages to the sidebar.

    Try: “Search for Daft Punk, queue their top three tracks and press play.”

    Delete · call

From the official docs

Permissions

high risk · 4 things to watch

High risk

The assistant can do nearly anything you can do in the player, including changing settings and deleting playlists. The server only listens on your own machine, and it only runs while the app is open with the MCP switch on.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can delete playlists, folders and favorites

    Delete methods exist for playlists, folders and favorites. Ask the assistant to confirm before removing anything. github.com

  • It can change your player settings

    A settings method can write any setting by its ID. Turn off the MCP switch when you are not using it. github.com

  • Any program on your computer can reach it

    There is no token, so any local program can connect while the switch is on. Leave it off when not needed. github.com

  • It can add pages to the app from code

    A views method takes TSX source from the assistant and shows it as a sidebar page until you restart. Only use it with an assistant you trust. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyNo read-only mode is documented. The call tool can run any method, including deletes and settings changes.
Talks toNone beyond what Nuclear itself does to reach music providers
Sign-in and keysNo account, key or token. The server listens on localhost only.

Questions

Is the Nuclear MCP server official?

Yes. It is built into the Nuclear app by its developers and lives in the nukeop/nuclear repository. You switch it on in the app's Settings.

What is the Nuclear MCP server URL?

It is http://127.0.0.1:8800/mcp. If port 8800 is taken, Nuclear tries 8801 up to 8809, and the Settings screen shows the real address.

How do I turn it on?

Open Nuclear, go to Settings, then Integrations, and switch on Enable MCP Server. Then add the address to your assistant as shown in the install box.

Do I need an account or API key?

No. It runs inside the app on your own computer and takes no credentials.

Why are there only four tools?

The server uses a discover-then-act design. The assistant lists the methods in an area, reads one method's details, and then runs it with the call tool. That keeps each reply small.

Can it play music from the internet?

It controls the player, which finds and streams music through its plugins. What it can play depends on the plugins you have installed.

Is there a skill to help my assistant use it?

Yes. The project offers a downloadable skill file that teaches an agent the discovery steps and the API. It is optional.

Is it free?

Yes. Nuclear is open source under AGPL-3.0.

Information

updated Nov 2, 2026

Publisher
Official
Transport
Streamable HTTP
Auth
None
License
AGPL-3.0
Last commit
Oct 31, 2026
Open issues
1

WebsiteGitHubChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 3
  1. mcp-server.md · github.com
  2. README.md · github.com
  3. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.