TIDALMCP v1.4.0

Local-first · open source · safety-gated

Your AI deserves more than a playlist toy.

TIDAL MCP gives Codex, Claude, Cursor, and other AI assistants a complete local control surface for TIDAL: search, analysis, discovery, favorites, folders, and carefully approved playlist writes.

Install in one command View source

MIT licensed · npm provenance · macOS and Linux · no developer key

122 typed tools
01Search
02Library
03Playlists
04Discovery
05Lyrics
06Folders
07Radio
08Safe writes
84read tools
36exact previews
2approval commits
100%statement + branch coverage

01 / Capability map

One server. The whole listening system.

Every operation has a named tool, bounded inputs, structured output, pagination, and safety annotations. No unrestricted private-endpoint proxy hiding behind one vague command.

73—84

Catalog, search, recommendations

Tracks, albums, artists, videos, barcodes, ISRCs, lyrics, artwork, and playback metadata.

  • Multi-type search
  • Deep metadata
  • Public-field allowlist
26—42

Discovery and editorial

Home, Explore, For You, genres, moods, hi-res, local hubs, and page-by-page editorial navigation.

43—72

Artists, albums, mixes, videos

Discographies, appearances, reviews, biographies, related artists, mixes, and video metadata.

01—25

Collection, analysis, export

Favorites, playlists, folders, counts, full-playlist collection, summaries, playlist comparison, and export to JSON or M3U.

85—120

Mutation previews

Create, edit, merge, reorder, favorite, organize, and delete—with an exact preview first.

121—122

Approval commits

Two deliberately narrow commit gates execute only the action stored in a short-lived local draft.

02 / Speak normally

Ask for outcomes, not API calls.

ANALYZE

“Analyze my entire workout playlist: artist concentration, eras, duplicates, duration, and sequencing.”

DISCOVER

“Find 20 related tracks, exclude everything I already saved, and use at most two tracks per artist.”

ORGANIZE

“Prepare a new playlist from these recommendations and show me the exact changes before doing anything.”

03 / Human in the loop

Writes are possible. Surprises are not.

Account mutations are disabled by default. When you enable them, the assistant still cannot jump straight to a remote change. The protocol is deliberately split into an inspectable local draft and a separately approved commit.

Read the security model
  1. 1
    Preview

    Resolve the exact target, parameters, track order, and destructive flag.

  2. 2
    Approve

    You review the proposed action before any remote mutation is allowed.

  3. 3
    Commit

    A short-lived, single-use token executes only the stored action.

04 / Evidence, not adjectives

The completeness claim is dated and reproducible.

In the public repository review performed on September 4, 2026, TIDAL MCP exposed 112 tools, the broadest explicitly registered tool surface found; the current repository exposes 122. Tool count alone is not quality, so the review also records schemas, write safety, tests, transports, commits, and limitations.

Reproducible comparisonView evidence ↗ Cross-platform test gateView CI ↗ Signed npm releaseView provenance ↗ Official registry recordView record ↗

Claim scope: public implementations discoverable and inspected on the snapshot date. This is not an official TIDAL endorsement or a permanent claim about every future project.

05 / Start listening

One command. Local credentials. Your account.

01 — AUTHENTICATEmacOS / Linux
npx -y @sickn33/tidal-mcp@1.4.0 auth
02 — MCP CONFIGstdio
{
  "mcpServers": {
    "tidal": {
      "command": "npx",
      "args": ["-y", "@sickn33/tidal-mcp@1.4.0"],
      "env": { "TIDAL_MCP_ENABLE_WRITES": "1" }
    }
  }
}
Works withCodexClaude DesktopClaude CodeCursorstdio MCP clients

06 / Direct answers

TIDAL MCP FAQ

What is TIDAL MCP?+

TIDAL MCP is a local open-source Model Context Protocol server that gives compatible AI assistants 122 typed tools for searching, analyzing, organizing, and safely modifying a TIDAL account.

Can it create and edit playlists?+

Yes. Writes are disabled by default. When enabled, every remote mutation still requires a local preview followed by an explicit approval-token commit.

Which AI clients work with it?+

Any local stdio-compatible MCP client should work, including Codex, Claude Desktop, Claude Code, Cursor, and similar clients.

Where are credentials stored?+

The OAuth session remains in your operating system’s private application-data directory. Session objects and OAuth tokens are excluded from MCP responses.

Is this an official TIDAL product?+

No. It is an independent, unofficial open-source project and is not affiliated with, endorsed by, or sponsored by TIDAL.

122 ways in.
One careful way to write.

Get TIDAL MCP Free · MIT · local-first