Power your agent
The publisher's own command. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
uvx upnote-lens-mcp==0.1.2Claude Code has no install link for a local command. Copy the command below and run it in a terminal.
claude mcp add io.github.awesomehye-upnote-lens-mcp -- uvx upnote-lens-mcp==0.1.2Run in a terminal.
{ "mcpServers": { "io.github.awesomehye-upnote-lens-mcp": { "command": "uvx", "args": [ "upnote-lens-mcp==0.1.2" ] } }}claude_desktop_config.json
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
A hybrid MCP server that lets your AI assistant work with your UpNote notes:
Read, search, and summarize your UpNote notes — and create new ones.
Under the hood: reads come from the local UpNote SQLite database (read-only),
so real content comes back as text; writes go through the upnote:// URL scheme
(x-callback-url) and never touch the database.
The write side (URL scheme) is based on chadthornton/upnote-mcp (MIT).
Once it's registered, just talk to your AI assistant in plain language — it picks the right tool for you. No commands or syntax to memorize. For example:
Reading, searching, summarizing, and creating all happen through natural conversation.
%APPDATA%\UpNote\. This path is
not verified by the author — if reads fail, set UPNOTE_LENS_DB (see below).Give your MCP client (Claude, etc.) a link to
llms-install.md and it will run the steps and set everything
up for you.
Pick the first option that fits what you already have. Each option includes how to register it in Claude.
Claude Desktop config file (referenced in each option):
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json- Windows:
%APPDATA%\Claude\claude_desktop_config.json
Requires uv installed once
(brew install uv, or curl -LsSf https://astral.sh/uv/install.sh | sh).
After that there's no package install step — uvx downloads, caches, and
runs upnote-lens-mcp on demand.
Claude Code:
claude mcp add upnote-lens -- uvx upnote-lens-mcp
Claude Desktop:
{ "mcpServers": { "upnote-lens": { "command": "uvx", "args": ["upnote-lens-mcp"] } } }
pip install upnote-lens-mcp
Claude Code:
claude mcp add upnote-lens -- upnote-lens-mcp
Claude Desktop:
{ "mcpServers": { "upnote-lens": { "command": "upnote-lens-mcp" } } }
When you can't use PyPI/pip, install straight from the repo with uv. (No uv yet?
curl -LsSf https://astral.sh/uv/install.sh | sh.)
Claude Code:
claude mcp add upnote-lens -- uvx --from git+https://github.com/AwesomeHye/upnote-lens-mcp upnote-lens-mcp
Claude Desktop:
{ "mcpServers": { "upnote-lens": { "command": "uvx", "args": ["--from", "git+https://github.com/AwesomeHye/upnote-lens-mcp", "upnote-lens-mcp"] } } }
upnote:// URL scheme)Tag limitation: UpNote's
note/newURL scheme has no tag parameter, and hashtags placed in the body stay as plain text rather than becoming real tags (they only convert to tags when typed in the editor). If you need tags, add them manually in the app after the note is created.
If the database isn't in the default location (or you're on Windows), point at it with an environment variable:
UPNOTE_LENS_DB=/path/to/upnote.sqlite3
Default paths:
~/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3%APPDATA%\UpNote\upnote.sqlite3MIT. See LICENSE for details. The URL-scheme formats and launch approach on the write side are adapted from chadthornton/upnote-mcp (MIT).
© 2026 MCP Directory.
Read, search, and summarize your UpNote notes — and create new ones.
{ "mcpServers": { "io.github.awesomehye-upnote-lens-mcp": { "command": "uvx", "args": [ "upnote-lens-mcp==0.1.2" ] } }}Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Upnote Lens runs locally over stdio.
Last checked 2026-11-08. Read, search, and summarize your UpNote notes — and create new ones.