TIDALMCP v1.0.1

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

112 typed tools
01Search
02Library
03Playlists
04Discovery
05Lyrics
06Folders
07Radio
08Safe writes
74read 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.

01—18

Catalog intelligence

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

  • Multi-type search
  • Deep metadata
  • Public-field allowlist
19—34

Discovery

Home, Explore, For You, genres, moods, hi-res, mixes, videos, and local hubs.

35—52

Artists + albums

Discographies, appearances, reviews, biographies, related artists, and similar albums.

53—74

Your collection

Favorites, owned and public playlists, counts, mixed items, folders, and account metadata.

75—110

Mutation previews

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

111—112

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 the broadest explicitly registered tool surface found. 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.0.1 auth
02 — MCP CONFIGstdio
{
  "mcpServers": {
    "tidal": {
      "command": "npx",
      "args": ["-y", "@sickn33/tidal-mcp@1.0.1"],
      "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 112 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.

112 ways in.
One careful way to write.

Get TIDAL MCP Free · MIT · local-first