What it does
The server gives an AI assistant access to UpNote notes. It searches by keyword across note titles and bodies, returns the full text of a note so the assistant can summarize it or answer questions about it, lists recent notes, notebooks and tags, and creates new notes from the chat. Reads come from the local UpNote SQLite database, which is opened read-only. Writes go through the upnote:// URL scheme and do not touch the database.
It suits cases where you want to query your own UpNote notes in plain language, for example to summarize notes on a project, find notes that mention a topic, or list your latest notes. Requests are made conversationally, and the assistant selects the appropriate tool, so no commands need to be memorized.
It is registered with an MCP client such as Claude Code or Claude Desktop and can be installed with uv, pip, or directly from the GitHub repository. The UpNote desktop app must be installed. The database path defaults to a macOS location and can be changed with an environment variable. The write-side URL formats are adapted from chadthornton/upnote-mcp, and the project is released under the MIT licence.
Limitations and requirements
macOS is fully supported and verified. Windows support is best-effort: the default database path is a guess and has not been verified by the author, so the UPNOTE_LENS_DB variable may need to be set if reads fail. The UpNote desktop app must be installed. Python 3.10 or later is required, unless uv is used. The create_note tool cannot set tags, and hashtags in the body remain plain text; tags must be added manually in the app after the note is created.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.AwesomeHye/upnote-lens-mcp
Read, search, and summarize your UpNote notes — and create new ones.
v0.1.2As shown on registry.modelcontextprotocol.io when we last read it