{"_id":"@imenam/youtube-playlist-manager","_rev":"4-7b4ded8b7ae1942b16618c84200d8172","name":"@imenam/youtube-playlist-manager","dist-tags":{"latest":"1.0.18"},"versions":{"0.0.0-stage":{"name":"@imenam/youtube-playlist-manager","version":"0.0.0-stage","_id":"@imenam/youtube-playlist-manager@0.0.0-stage","stub":true,"maintainers":[{"name":"imenam","email":"matthieupin@gmail.com"}],"dist":{"shasum":"a928516a541845126fc112cb70b49c094d738b5d","tarball":"https://registry.npmjs.org/@imenam/youtube-playlist-manager/-/youtube-playlist-manager-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-7F7CyeZQfhLzYZ2b4cGKo9jVzZKPwIfVhBcOyR+l+L6AkVTZSh0/xeuW6YCrSiRz6mEOM6YrZCRa/RQDpBGItg==","signatures":[{"sig":"MEYCIQDu11i4FEVFJydTLXN+z04cxkPpxOXl6LHCQLCxh6QZfgIhAOF2SmVeQur5Y3duEvgwAClj7aCWR+hNsOUACMfSFOMp","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":354},"_npmUser":{"name":"imenam","email":"matthieupin@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.0.16":{"name":"@imenam/youtube-playlist-manager","version":"1.0.16","keywords":["mcp","youtube","playlist","model-context-protocol","claude","ai","cursor"],"author":"","license":"ISC","_id":"@imenam/youtube-playlist-manager@1.0.16","maintainers":[{"name":"imenam","email":"matthieupin@gmail.com"}],"bin":{"youtube-playlist-manager":"dist/index.js"},"dist":{"shasum":"59c7bc79d84bcc09fa62d3991c70933c26da9dd4","tarball":"https://registry.npmjs.org/@imenam/youtube-playlist-manager/-/youtube-playlist-manager-1.0.16.tgz","fileCount":13,"integrity":"sha512-s3P40gP2Wc0at53MAlwTKfuNiUDCRAeD1NBHlxZlnrj/QkmwLN7oFvxsbm12wiHBRpdPNpDIJVL3SwxS9GPFtA==","signatures":[{"sig":"MEUCIQDO0Ci/OaNWg7y5f/23LlCSj1jU6aWlBmhQpi8tSIKhVwIgK5iHMgUUN1OJuqqS30k7K3VQV/5RLiVAUhiqw9z0IjU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQC9l7WcWGirimhU5mogni29Orc7YYRPlWqCA6DHAlGVsAIgegiJIIOR9OXBLT0HDA4Pz8LheVN0jTrHXW61sboRWnk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":272558},"main":"dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"ad195e5cfc879f91862e20e6322ddaa538e2e6e6","scripts":{"dev":"ts-node src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"npm run build:backend && npm run build:frontend","start":"node dist/index.js","release":"npm version patch && npm publish --access public && git push origin master --follow-tags","install:gui":"npm install --prefix gui","build:backend":"tsc","build:frontend":"npm run build --prefix gui","prepublishOnly":"npm run build"},"_npmUser":{"name":"imenam","email":"matthieupin@gmail.com"},"_npmVersion":"12.0.2","description":"MCP server for managing YouTube playlists with OAuth2 and a React GUI","directories":{},"_nodeVersion":"22.23.2","dependencies":{"zod":"^4.3.6","cors":"^2.8.6","dotenv":"^17.3.1","express":"^5.2.1","googleapis":"^171.4.0","@imenam/mcp-gui-interface":"^1.0.14","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/cors":"^2.8.19","@types/node":"^25.3.0","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/youtube-playlist-manager_1.0.16_1793645597642_0.18254141741652474","host":"s3://npm-registry-packages-npm-production"}},"1.0.17":{"name":"@imenam/youtube-playlist-manager","version":"1.0.17","keywords":["mcp","youtube","playlist","model-context-protocol","claude","ai","cursor"],"author":"","license":"ISC","_id":"@imenam/youtube-playlist-manager@1.0.17","maintainers":[{"name":"imenam","email":"matthieupin@gmail.com"}],"homepage":"https://github.com/Matthieu-Pesnot-Pin/youtube-playlist-manager#readme","bugs":{"url":"https://github.com/Matthieu-Pesnot-Pin/youtube-playlist-manager/issues"},"bin":{"youtube-playlist-manager":"dist/index.js"},"dist":{"shasum":"4248291e1a08f80c7b6a2645b3fa1801fa365bfa","tarball":"https://registry.npmjs.org/@imenam/youtube-playlist-manager/-/youtube-playlist-manager-1.0.17.tgz","fileCount":12,"integrity":"sha512-PuDWiYo8WCwQiNB6qpnSnE8k+5T6lcdrZj/kcSbYr1DEH6jC3GsFx6kfRcGMkyWIZkkv8fbUyYfzz7j2DO3Npw==","signatures":[{"sig":"MEUCIQDqAD7TmdJIKw/hVs6yFvdvNc4U1SXXfBhwshwo23hHBQIgY3x1agPmC8+7FliUiPZ10FfA/kyYyke+FuAX93QMjvI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCICk4KM9hQyYNnGZwUwa9W5JbgAqGjh1yvMoDfkYiXXN4AiEA7/Yhv01R8SL1rZqqSXBgFTtIUgXFQr7O+ww8SqcDm0M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":270974},"main":"dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"6511ec96067aa7e4c1a189e5e40f720aad85dae3","scripts":{"dev":"ts-node src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"npm run build:backend && npm run build:frontend","start":"node dist/index.js","install:gui":"npm install --prefix gui","build:backend":"tsc","build:frontend":"npm run build --prefix gui","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"0c42b23a-8943-4858-b5e9-4c06c5c17849"}},"repository":{"url":"git+https://github.com/Matthieu-Pesnot-Pin/youtube-playlist-manager.git","type":"git"},"_npmVersion":"11.19.1","description":"MCP server for managing YouTube playlists with OAuth2 and a React GUI","directories":{},"_nodeVersion":"24.22.2","dependencies":{"zod":"^4.3.6","cors":"^2.8.6","dotenv":"^17.3.1","express":"^5.2.1","googleapis":"^171.4.0","@imenam/mcp-gui-interface":"^1.0.14","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/cors":"^2.8.19","@types/node":"^25.3.0","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/youtube-playlist-manager_1.0.17_1793973628648_0.3034049510476674","host":"s3://npm-registry-packages-npm-production"}},"1.0.18":{"_id":"@imenam/youtube-playlist-manager@1.0.18","bin":{"youtube-playlist-manager":"dist/index.js"},"bugs":{"url":"https://github.com/Matthieu-Pesnot-Pin/youtube-playlist-manager/issues"},"dist":{"shasum":"6f823a6df6f5104880e4cfacb8679fc4ebe1fbf1","tarball":"https://registry.npmjs.org/@imenam/youtube-playlist-manager/-/youtube-playlist-manager-1.0.18.tgz","fileCount":12,"integrity":"sha512-0lEshDkh7lyKtuEFjeYvlojnAK96eNqS+P9KSR4Urhx5f7JGyhlm7xVW7ty5gFlUa7uQU+32R5EyC0WZ/J4QIw==","signatures":[{"sig":"MEQCIEb4jg24jI1V1rjuesUTtXtfX1t7zvzDQdegJeEmyDopAiB+4eNkbUgSXu/yak++LTgKcc8hhrCYO2U+g09wjeJHUA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCwid9PH8gl7rwDV78xKnyruHOAu42eKhY1lTCl6kk10wIgRKZ+fOk6YpPNKUk63YEE4hL04G1qgcTYR2UWVryTg/I="}],"unpackedSize":271020},"main":"dist/index.js","name":"@imenam/youtube-playlist-manager","type":"module","author":"","engines":{"node":">=18.0.0"},"gitHead":"529167f08f93e08992de1c497b6c08b58d6c2230","license":"ISC","scripts":{"dev":"ts-node src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"npm run build:backend && npm run build:frontend","start":"node dist/index.js","install:gui":"npm install --prefix gui","build:backend":"tsc","build:frontend":"npm run build --prefix gui","prepublishOnly":"npm run build"},"version":"1.0.18","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"0c42b23a-8943-4858-b5e9-4c06c5c17849"}},"homepage":"https://github.com/Matthieu-Pesnot-Pin/youtube-playlist-manager#readme","keywords":["mcp","youtube","playlist","model-context-protocol","claude","ai","cursor"],"repository":{"url":"git+https://github.com/Matthieu-Pesnot-Pin/youtube-playlist-manager.git","type":"git"},"_npmVersion":"11.19.1","description":"MCP server for managing YouTube playlists with OAuth2 and a React GUI","directories":{},"maintainers":[{"name":"imenam","email":"matthieupin@gmail.com"}],"_nodeVersion":"24.22.2","dependencies":{"zod":"^4.3.6","cors":"^2.8.6","dotenv":"^17.3.1","express":"^5.2.1","googleapis":"^171.4.0","@imenam/mcp-gui-interface":"^1.0.14","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/cors":"^2.8.19","@types/node":"^25.3.0","@types/express":"^5.0.6"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/youtube-playlist-manager_1.0.18_1794734762533_0.590849803730145"}}},"time":{"created":"2026-11-02T18:52:22.298Z","modified":"2026-11-15T09:26:02.808Z","0.0.0-stage":"2026-11-02T18:52:22.298Z","1.0.16":"2026-11-02T18:53:17.733Z","1.0.17":"2026-11-06T14:00:28.790Z","1.0.18":"2026-11-15T09:26:02.630Z"},"bugs":{"url":"https://github.com/Matthieu-Pesnot-Pin/youtube-playlist-manager/issues"},"license":"ISC","homepage":"https://github.com/Matthieu-Pesnot-Pin/youtube-playlist-manager#readme","keywords":["mcp","youtube","playlist","model-context-protocol","claude","ai","cursor"],"repository":{"url":"git+https://github.com/Matthieu-Pesnot-Pin/youtube-playlist-manager.git","type":"git"},"description":"MCP server for managing YouTube playlists with OAuth2 and a React GUI","maintainers":[{"name":"imenam","email":"matthieupin@gmail.com"}],"readme":"# youtube-playlist-manager\n\nAn MCP (Model Context Protocol) server that lets Claude and other AI assistants manage your YouTube playlists. Includes a React GUI accessible via a browser.\n\n## Features\n\n- List, search, create, update and delete playlists\n- Add and remove videos from playlists\n- Get video details\n- React-based GUI for visual management\n- OAuth2 authentication with automatic token refresh\n\n## Prerequisites\n\n- Node.js >= 18\n- A Google Cloud project with the **YouTube Data API v3** enabled\n- OAuth 2.0 credentials (Client ID + Client Secret) of a **Web application** client (see [Authorization](#authorization))\n\n## Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"youtube-playlist-manager\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@imenam/youtube-playlist-manager\"],\n      \"env\": {\n        \"GOOGLE_CLIENT_ID\": \"123456789012-abc….apps.googleusercontent.com\",\n        \"GOOGLE_CLIENT_SECRET\": \"GOCSPX-…\",\n        \"PROXY_URL\": \"http://localhost:3000\"\n      }\n    }\n  }\n}\n```\n\nFor a local unpublished copy, replace `command` and `args` with\n`\"command\": \"node\", \"args\": [\"<path>/youtube-playlist-manager/dist/index.js\"]`.\n\n| Variable | Required | Description |\n|---|---|---|\n| `GOOGLE_CLIENT_ID` | yes | OAuth client ID (Google Cloud console) |\n| `GOOGLE_CLIENT_SECRET` | yes | OAuth client secret |\n| `PROXY_URL` | for the interface | URL of the proxy the interface registers with; without it the interface is disabled |\n| `APP_PATH` | no | Path of the interface behind the proxy (default `/youtube-playlist-manager`, prefixed with `APP_PATH_PREFIX` when a hub sets it) |\n| `APP_NAME` | no | Name of the interface in the proxy (default `YouTube Playlist Manager`) |\n| `APP_GROUP` | no | Collapsible section of the proxy dashboard the interface is listed in |\n\nVariables come from the MCP `env` block or from `~/.config/youtube-playlist-manager/.env`. When both are present, the `.env` file wins (it is loaded with `override: true`).\n\n> **Windows:** `~` refers to `C:\\Users\\<YourName>\\.config\\youtube-playlist-manager\\.env`\n\n## Authorization\n\nFrom the interface: *Se connecter à YouTube*. The OAuth client is a **Web application** client. Google's return address is derived from the address of the interface page:\n\n| Interface served by | Address to declare once in the client's *Authorized redirect URIs* |\n|---|---|\n| the self-register proxy, e.g. `http://localhost:3000/youtube-playlist-manager/` | `http://localhost:3000/youtube-playlist-manager/oauth2callback` |\n| an MCP Gateway Manager hub, under `/_gui/…` | `https://<hub>/_oauth-return` — one address for every gateway of the hub, which sends the browser back to the interface named in `state` |\n\n## Available Tools\n\n| Tool | Description |\n|---|---|\n| `list_playlists` | List all your YouTube playlists |\n| `search_playlists` | Search playlists by title |\n| `get_playlist_items` | Get videos inside a playlist |\n| `get_video_details` | Get details of a specific video |\n| `add_video_to_playlist` | Add a video to a playlist |\n| `remove_video_from_playlist` | Remove a video from a playlist |\n| `create_playlist` | Create a new playlist |\n| `update_playlist` | Update title, description or privacy |\n| `delete_playlist` | Permanently delete a playlist |\n\n## Config directory\n\nAll user data is stored in `~/.config/youtube-playlist-manager/`:\n\n| File | Purpose |\n|---|---|\n| `.env` | Your Google OAuth credentials |\n| `tokens.json` | OAuth tokens (auto-managed) |\n\n## Network exposure\n\nThe GUI server listens on `127.0.0.1` only. Other machines reach the GUI through the proxy or the gateway manager, which relay to `localhost`.\n\nEvery GUI request goes through the request guard of `@imenam/mcp-gui-interface`: it refuses (HTTP 403) a `Host` header other than `localhost` / `127.0.0.1` / `::1`, and any modifying request (other than GET, HEAD, OPTIONS) that the browser marks as coming from another site (`Sec-Fetch-Site`, or `Origin` outside this machine and the proxy).\n\n## Development\n\n```bash\ngit clone https://github.com/your-username/youtube-playlist-manager\ncd youtube-playlist-manager\nnpm install\nnpm run install:gui\nnpm run build\n```\n\n## Publishing\n\nEvery push to `master`, pull request merges included, publishes a new version of `@imenam/youtube-playlist-manager` to npm (`.github/workflows/publish.yml`): `npm ci` (root and `gui`), `npm run build`, then `npm version patch`, whose commit and tag are pushed to `master`, and `npm publish`. Publishing goes through npm trusted publishing (OIDC, no token), with provenance attestation.\n\nOn npmjs.com, the package declares this workflow as its trusted publisher (Settings → Trusted publishing → GitHub Actions: `Matthieu-Pesnot-Pin`, `youtube-playlist-manager`, `publish.yml`, with `npm publish` among the allowed actions). The version commit is pushed with `GITHUB_TOKEN`: if `master` is protected, the rule must allow GitHub Actions to push to it.\n\n## License\n\nISC\n","readmeFilename":"README.md"}