io.github.ryanbiddy/uoink
16 changes recorded. MCP Harbor re-reads this listing from the official registry every six hours and asks the live server what it exposes, and keeps what changed between one look and the next.
− # Uoink v3.11.2− A local library of the YouTube videos, podcasts and articles you study, saved on your Windows PC, that your AI can search and cite with timestamps.− Windows 10/11, plus a Mac preview for Apple Silicon (macOS 15 or later). Uoink v3.11.2 is free and MIT-licensed; the unsigned Windows installer is about 390 MB. No admin rights needed.− 1. Download [Uoink-Setup-3.11.2.exe](https://github.com/ryanbiddy/uoink/releases/download/v3.11.2/Uoink-Setup-3.11.2.exe) to `$env:TEMP\Uoink-Setup-3.11.2.exe`.− 2. Before running it, compare `Get-FileHash -Algorithm SHA256 "$env:TEMP\Uoink-Setup-3.11.2.exe"` with the installer entry in [SHA256SUMS.txt](https://github.com/ryanbiddy/uoink/releases/download/v3.11.2/SHA256SUMS.txt).− 3. Install per user: `Start-Process -Wait -FilePath "$env:TEMP\Uoink-Setup-3.11.2.exe" -ArgumentList '/VERYSILENT','/SUPPRESSMSGBOXES','/NORESTART'`. It installs to `%LOCALAPPDATA%\Uoink` with Add the uoink command to PATH for AI agents checked by default. Installing over the previous release keeps the library and saved captures; upgrading from before 3.11.0 rebuilds the local keyword search index once.− 4. Open a new terminal, run `uoink status`, then connect a client below. Silent install does not start Uoink; MCP works without it running. For the dashboard, browser button, and monitored-playlist polling, start "Uoink" from the Start menu or run `& "$env:LOCALAPPDATA\Uoink\python\pythonw.exe" "$env:LOCALAPPDATA\Uoink\server.py"` in PowerShell.− 1. Download [Uoink-3.11.2-macos-arm64.dmg](https://github.com/ryanbiddy/uoink/releases/download/v3.11.2/Uoink-3.11.2-macos-arm64.dmg) and check it against the SHA-256 on the release page. Open it, drag Uoink to Applications, eject the disk, and open Uoink from Applications.− 3. The uoink command is `/Applications/Uoink.app/Contents/Helpers/uoink`; the app does not change PATH, so link it into a folder on PATH. Run `uoink status`, then `uoink connect <client>` for a recipe with the app's paths. Claude Desktop: open [uoink-3.11.2-macos.mcpb](https://github.com/ryanbiddy/uoink/releases/download/v3.11.2/uoink-3.11.2-macos.mcpb), not the Windows bundle.− Not on the Mac yet: self-update and library mirroring. MCP clients on a Mac are not yet tested.− 3.11.1 Agent Install 27: 11/11 PASS, including stdio with 91 full / 35 core / 91 modern tools and Claude Code 2.1.310 (haiku) connected with 91 tools and a get_schema_version call. Codex CLI was not re-tested in receipt 27. Full receipt scope: https://uoink.app/llms-full.txt.− - Claude Desktop on Windows: download and open [uoink-3.11.2.mcpb](https://github.com/ryanbiddy/uoink/releases/download/v3.11.2/uoink-3.11.2.mcpb) for one-click setup. It installs as an extension and asks for the Uoink folder (%LOCALAPPDATA%\Uoink). Enter the full path; Desktop does not expand %LOCALAPPDATA%. Reinstall the bundle and restart Desktop after updating.− - Cursor: use the config below and add `"UOINK_MCP_TOOLSET": "core"` to the server env for the previous 35-tool set. Cursor is reported to send only the first 40 tools to its agent; core stays under that cap.− 91 tools over stdio and 91 in the HTTP registry. Every tool is on both transports; consent gates are unchanged.− - Capture: video, playlists, podcasts, pages, X, Reddit, notes, and images.− [Install](https://uoink.app/install) | [Developers](https://uoink.app/developers) | [MCP](https://uoink.app/mcp)− [Features](https://uoink.app/features) | [Sources](https://uoink.app/sources) | [Changelog](https://uoink.app/changelog)− [GitHub](https://github.com/ryanbiddy/uoink) | [Release notes](https://github.com/ryanbiddy/uoink/releases/tag/v3.11.2)+ # Uoink v3.14.1+ > Uoink is a free, open-source local library of the YouTube videos, podcasts, X posts and articles you study, saved on your own computer (Windows, plus a Mac preview), that your AI can search and cite with timestamps.+ New in 3.14.1: deep research returns excerpts from videos saved outside a research run again. CLI text output has readable timestamp ranges and titles; research reports and saves import labels are corrected. JSON output is unchanged. No new tools or database migrations.+ 3.14.0 added deep research with checked quotes and timestamps; `get_transcript` tries your saved copy, then captions, then local Whisper; import YouTube Watch Later, X bookmarks and Reddit saves; weekly checks flag sources Gone from the web; and agents can run headless on Linux in Docker, Codespaces and sandboxes. Network research needs consent. File imports are tested; browser collectors have not yet been tried in a real browser. YouTube can block cloud IPs even with Whisper available. 3.13.0 a+ - Deep research checks quotes and timestamps before saving your agent's report.+ - Import YouTube Watch Later, X bookmarks and Reddit saves.+ - Gone from the web shows which saved sources have disappeared.+ - Run headless on Linux for agents in Docker, Codespaces and sandboxes.+ Windows 10/11, a Mac preview for Apple Silicon (macOS 15 or later), and headless Linux for agents. Uoink v3.14.1 is free and MIT-licensed; the unsigned Windows installer is about 519 MB. No admin rights needed.+ 1. Download [Uoink-Setup-3.14.1.exe](https://github.com/ryanbiddy/uoink/releases/download/v3.14.1/Uoink-Setup-3.14.1.exe) to `$env:TEMP\Uoink-Setup-3.14.1.exe`.+ 2. Before running it, compare `Get-FileHash -Algorithm SHA256 "$env:TEMP\Uoink-Setup-3.14.1.exe"` with the installer entry in [SHA256SUMS.txt](https://github.com/ryanbiddy/uoink/releases/download/v3.14.1/SHA256SUMS.txt).+ 3. Install per user: `Start-Process -Wait -FilePath "$env:TEMP\Uoink-Setup-3.14.1.exe" -ArgumentList '/VERYSILENT','/SUPPRESSMSGBOXES','/NORESTART'`. It installs to `%LOCALAPPDATA%\Uoink` with Add the uoink command to PATH for AI agents checked by default. Installing over the previous release keeps the library and saved captures; upgrading from before 3.11.0 rebuilds the local keyword search index once.+ 4. Open a new terminal, run `uoink status`, then connect a client below. A silent install starts Uoink in the background, and a silent upgrade restarts it only if it was running; MCP works without it running. If it is not running, for the dashboard, browser button, and monitored-playlist polling, start "Uoink" from the Start menu or run `& "$env:LOCALAPPDATA\Uoink\python\pythonw.exe" "$env:LOCALAPPDATA\Uoink\server.py"` in PowerShell.+ 1. Download [Uoink-3.14.1-macos-arm64.dmg](https://github.com/ryanbiddy/uoink/releases/download/v3.14.1/Uoink-3.14.1-macos-arm64.dmg) and check it against the SHA-256 on the release page. Open it, drag Uoink to Applications, eject the disk, and open Uoink from Applications.+ 3. The uoink command is `/Applications/Uoink.app/Contents/Helpers/uoink`; the app does not change PATH, so link it into a folder on PATH. Run `uoink status`, then `uoink connect <client>` for a recipe with the app's paths. Claude Desktop: open [uoink-3.14.1-macos.mcpb](https://github.com/ryanbiddy/uoink/releases/download/v3.14.1/uoink-3.14.1-macos.mcpb), not the Windows bundle.+ Not on the Mac yet: self-update and library mirroring. On a Mac, Claude Code passed MCP acceptance (3.11.2); other clients are untested there.+ ## Linux (headless)+ Install from the v3.14.1 checkout with `sh uoink/scripts/linux/install.sh`, then run `uoink mcp`. A host install needs Git, Python 3.11 or newer, venv support, ffmpeg and ffprobe. `docker/capture.Dockerfile` builds the capture image. See [Linux setup](https://github.com/ryanbiddy/uoink/blob/v3.14.1/docs/linux.md).+ 3.13.0 Agent Install 32 (installed build, isolated profile): 26/26 PASS, including Claude Code 2.1.316 (haiku) with 92 tools, an import-list preview, and an in-place upgrade over 3.12.1. Earlier, 3.12.1 Agent Install 31: 24/24 PASS, including Claude Code 2.1.316 (haiku) with 91 tools, uoink mcp through both installed launchers, and a Wikipedia capture. Earlier, 3.12.0 Agent Install 30 (installed build, isolated profile): 21/21 PASS. The Whisper base model came with the install: with an empty Hug+ - Claude Desktop on Windows: download and open [uoink-3.14.1.mcpb](https://github.com/ryanbiddy/uoink/releases/download/v3.14.1/uoink-3.14.1.mcpb) for one-click setup. It installs as an extension and asks for the Uoink folder (%LOCALAPPDATA%\Uoink). Enter the full path; Desktop does not expand %LOCALAPPDATA%. Reinstall the bundle and restart Desktop after updating.+ - Cursor: use the config below and add `"UOINK_MCP_TOOLSET": "core"` to the server env for the 36-tool core set. Cursor is reported to send only the first 40 tools to its agent; core stays under that cap.+ 99 tools over stdio and 99 in the HTTP registry. Every tool is on both transports; consent gates are unchanged. Core mode has 36 tools, search mode 9 and research mode 7. Set UOINK_MCP_TOOLSET to core, search or research; full is the default.+ - Capture: video, playlists, podcasts, pages, X, Reddit, notes, and images; import_list queues a whole list of videos.+ - Transcripts: get_transcript uses a saved copy, then captions, then local Whisper, with source and fallback details.+ - Research: the deep-research prompt and six research_* tools, plus uoink_url in research mode.+ - Key pages: [Facts](https://uoink.app/facts) | [Install](https://uoink.app/install) | [How it works](https://uoink.app/how-it-works) | [Sources](https://uoink.app/sources) | [YouTube](https://uoink.app/sources/youtube) | [Podcasts](https://uoink.app/sources/podcasts) | [Features](https://uoink.app/features) | [Developers](https://uoink.app/developers) | [MCP tools](https://uoink.app/mcp) | [Changelog](https://uoink.app/changelog) | [Privacy](https://uoink.app/privacy)+ - Compare and use cases: [Uoink vs NotebookLM](https://uoink.app/compare/notebooklm) | [Uoink vs Readwise Reader](https://uoink.app/compare/readwise-reader) | [Uoink vs Obsidian Web Clipper](https://uoink.app/compare/obsidian-web-clipper) | [Uoink vs Recall](https://uoink.app/compare/recall) | [Uoink vs Snipd](https://uoink.app/compare/snipd) | [Uoink as a Pocket alternative](https://uoink.app/compare/pocket) | [Uoink vs YouTube transcript MCP servers](https://uoink.app/compare/youtube-transcrip+ - Elsewhere: [GitHub](https://github.com/ryanbiddy/uoink) | [Release notes](https://github.com/ryanbiddy/uoink/releases/tag/v3.14.1) | [Homebrew tap](https://github.com/ryanbiddy/homebrew-uoink) | [Glama](https://glama.ai/mcp/servers/ryanbiddy/uoink) | [MCP Market](https://mcpmarket.com/server/uoink) | [mcpservers.org](https://mcpservers.org/servers/ryanbiddy/uoink)
− # Uoink v3.10.0− A local library for the videos and podcasts you study, that any AI you use can search and cite.− Windows 10/11 only. No Mac build scheduled. Uoink v3.10.0 is free and MIT-licensed; the unsigned installer is about 390 MB. No admin rights needed.− 1. Download [Uoink-Setup-3.10.0.exe](https://github.com/ryanbiddy/uoink/releases/download/v3.10.0/Uoink-Setup-3.10.0.exe) to `$env:TEMP\Uoink-Setup-3.10.0.exe`.− 2. Before running it, compare `Get-FileHash -Algorithm SHA256 "$env:TEMP\Uoink-Setup-3.10.0.exe"` with the installer entry in [SHA256SUMS.txt](https://github.com/ryanbiddy/uoink/releases/download/v3.10.0/SHA256SUMS.txt).− 3. Install per user: `Start-Process -Wait -FilePath "$env:TEMP\Uoink-Setup-3.10.0.exe" -ArgumentList '/VERYSILENT','/SUPPRESSMSGBOXES','/NORESTART'`. It installs to `%LOCALAPPDATA%\Uoink` with Add the uoink command to PATH for AI agents checked by default. No data or settings changes besides the optional PATH entry; no new index or migration. Installing over the previous release keeps the library and saved captures.− - Setup recipes: `uoink connect --list` prints setup choices for 38 clients and integrations. Run `uoink connect <client>` for config or instructions and their destination; it does not edit client settings. Run the printed Claude Code command in PowerShell; merge other clients' entries into the location shown, then restart their MCP connection.− - CLI examples: `uoink search "working memory" --limit 5`, `uoink recent --limit 10`, `uoink note "A useful thought" --title "Research note"`. Agents can search sources, read evidence, capture URLs, save notes, and call registry tools. Local reads work without the helper running; capture and paid tools keep their existing gates. The agent must be able to execute Uoink on the Windows machine holding the library.− Tested on a clean, isolated install: Claude Code 2.1.302 over MCP (all 91 tools listed; a note saved and listed back); Claude Code with the skill and CLI only (skill loaded; uoink note and uoink recent ran); Codex CLI 0.153.4 over MCP (a note saved and listed back); CLI status, note, recent, and connect. The Claude Code plugin loads its skill and starts its MCP server; its tool calls were not run end to end because the test install is isolated from a normal one. Not yet tested: Gemini CLI and pi− - Claude Desktop: download and open [uoink-3.10.0.mcpb](https://github.com/ryanbiddy/uoink/releases/download/v3.10.0/uoink-3.10.0.mcpb) for one-click setup. It installs as an extension and asks for the Uoink folder (%LOCALAPPDATA%\Uoink). Enter the full path; Desktop does not expand %LOCALAPPDATA%. Reinstall the bundle and restart Desktop after updating.− - Claude Code (verified with 2.1.302): run in PowerShell: `claude mcp add --scope user --transport stdio uoink -e PYTHONIOENCODING=utf-8 -e PYTHONUTF8=1 -- "$env:LOCALAPPDATA\Uoink\python\python.exe" "$env:LOCALAPPDATA\Uoink\uoink_mcp.py"`.− - Other stdio clients: use this config with absolute paths. Full mode is the default. Cline and Continue were not individually smoke-tested.− [GitHub](https://github.com/ryanbiddy/uoink) | [Release notes](https://github.com/ryanbiddy/uoink/releases/tag/v3.10.0)+ # Uoink v3.11.2+ A local library of the YouTube videos, podcasts and articles you study, saved on your Windows PC, that your AI can search and cite with timestamps.+ Windows 10/11, plus a Mac preview for Apple Silicon (macOS 15 or later). Uoink v3.11.2 is free and MIT-licensed; the unsigned Windows installer is about 390 MB. No admin rights needed.+ 1. Download [Uoink-Setup-3.11.2.exe](https://github.com/ryanbiddy/uoink/releases/download/v3.11.2/Uoink-Setup-3.11.2.exe) to `$env:TEMP\Uoink-Setup-3.11.2.exe`.+ 2. Before running it, compare `Get-FileHash -Algorithm SHA256 "$env:TEMP\Uoink-Setup-3.11.2.exe"` with the installer entry in [SHA256SUMS.txt](https://github.com/ryanbiddy/uoink/releases/download/v3.11.2/SHA256SUMS.txt).+ 3. Install per user: `Start-Process -Wait -FilePath "$env:TEMP\Uoink-Setup-3.11.2.exe" -ArgumentList '/VERYSILENT','/SUPPRESSMSGBOXES','/NORESTART'`. It installs to `%LOCALAPPDATA%\Uoink` with Add the uoink command to PATH for AI agents checked by default. Installing over the previous release keeps the library and saved captures; upgrading from before 3.11.0 rebuilds the local keyword search index once.+ ## Set it up on a Mac (preview)+ Mac preview: Apple Silicon, macOS 15 or later; Intel Macs are not supported. The app and DMG are signed with a Developer ID and notarized by Apple, so macOS asks only its standard "downloaded from the internet" question.+ 1. Download [Uoink-3.11.2-macos-arm64.dmg](https://github.com/ryanbiddy/uoink/releases/download/v3.11.2/Uoink-3.11.2-macos-arm64.dmg) and check it against the SHA-256 on the release page. Open it, drag Uoink to Applications, eject the disk, and open Uoink from Applications.+ 2. Optional browser button: in Chrome, open chrome://extensions, enable Developer mode, click Load unpacked, press ⌘⇧G and paste `~/Library/Application Support/Uoink/extension` (the dashboard's Get the extension card copies it).+ 3. The uoink command is `/Applications/Uoink.app/Contents/Helpers/uoink`; the app does not change PATH, so link it into a folder on PATH. Run `uoink status`, then `uoink connect <client>` for a recipe with the app's paths. Claude Desktop: open [uoink-3.11.2-macos.mcpb](https://github.com/ryanbiddy/uoink/releases/download/v3.11.2/uoink-3.11.2-macos.mcpb), not the Windows bundle.+ Not on the Mac yet: self-update and library mirroring. MCP clients on a Mac are not yet tested.+ - MCP SDK 2.3.0: Claude Desktop, Claude Code, Cursor, and Codex connect as before; apps that speak the 2026-07-28 MCP protocol can also connect. No action needed.+ - Setup recipes: `uoink connect --list` prints setup choices for 48 clients and integrations, 10 of them new in 3.11.0; 45 are checked against each client's official documentation, and each recipe prints its verification status. Run `uoink connect <client>` for config or instructions and their destination; it does not edit client settings. Run the printed Claude Code command in PowerShell; merge other clients' entries into the location shown, then restart their MCP connection. Recipes list a Lin+ - CLI examples: `uoink search "working memory" --limit 5`, `uoink recent --limit 10`, `uoink note "A useful thought" --title "Research note"`. Agents can search sources, read evidence, capture URLs, save notes, and call registry tools. Local reads work without the helper running; capture and paid tools keep their existing gates. The agent must be able to execute Uoink on the computer holding the library.+ 3.11.1 Agent Install 27: 11/11 PASS, including stdio with 91 full / 35 core / 91 modern tools and Claude Code 2.1.310 (haiku) connected with 91 tools and a get_schema_version call. Codex CLI was not re-tested in receipt 27. Full receipt scope: https://uoink.app/llms-full.txt.+ Earlier testing with the installed 3.11.0 build in an isolated profile: Claude Code 2.1.308 over MCP (all 91 tools listed; a tool called) and Codex CLI 0.153.4 over MCP (two tools called). From 3.10.0 testing: Claude Code with the skill and CLI only (skill loaded; uoink note and uoink recent ran). The Claude Code plugin loads its skill and starts its MCP server; its tool calls were not run end to end because the test install is isolated from a normal one. Not yet tested: Gemini CLI and pi (no si+ - Claude Desktop on Windows: download and open [uoink-3.11.2.mcpb](https://github.com/ryanbiddy/uoink/releases/download/v3.11.2/uoink-3.11.2.mcpb) for one-click setup. It installs as an extension and asks for the Uoink folder (%LOCALAPPDATA%\Uoink). Enter the full path; Desktop does not expand %LOCALAPPDATA%. Reinstall the bundle and restart Desktop after updating.+ - Claude Code (verified on Uoink 3.10.0 with 2.1.302): run in PowerShell: `claude mcp add --scope user --transport stdio uoink -e PYTHONIOENCODING=utf-8 -e PYTHONUTF8=1 -- "$env:LOCALAPPDATA\Uoink\python\python.exe" "$env:LOCALAPPDATA\Uoink\uoink_mcp.py"`.+ - Other stdio clients: use this config with absolute paths. Full mode is the default. Cline and Continue were not individually smoke-tested. Continue is set up by hand; the dashboard shows it as connected once its entry launches this install.+ - Search modes: search no longer requires every word. search_library, search_uoinks, and search_clips take optional `match` ("forgiving" by default, "strict" to require every word) and `mode` ("auto" by default, "keyword", "semantic", "hybrid"); find_mentions takes `match`. Auto uses hybrid when semantic search is ready, otherwise keyword; each response says which mode ran. Quote a passage only when passage_verified is true.+ - Semantic search is optional and off until a person turns it on in Uoink Settings (Semantic search) and accepts Google's Gemma terms. Uoink then downloads EmbeddingGemma from Hugging Face once (about 330 MB) and runs it on this computer; it works offline after setup, and searches and saved text stay local.+ - Anonymous usage counts are off by default. If turned on in Settings, the helper sends one daily report of counts (tool calls, AI apps by a fixed name list, captures by source, searches) with a random install ID; never content, URLs, titles, paths or search text.+ [GitHub](https://github.com/ryanbiddy/uoink) | [Release notes](https://github.com/ryanbiddy/uoink/releases/tag/v3.11.2)
We can't find the internet
Attempting to reconnect
Something went wrong!
Attempting to reconnect