Upnote Lens Mcp

What is Upnote Lens Mcp?

Upnote Lens Mcp is a hybrid MCP server that lets your AI assistant read, search, summarize, and create notes in the UpNote note‑taking app. Reads come from the local UpNote SQLite database (read‑only), so real content is returned as text; writes go through the upnote:// URL scheme and never touch the database. It is designed for users of the UpNote desktop app on macOS (fully supported) or Windows (best‑effort) who want AI‑powered note access.

How to use Upnote Lens Mcp?

Install using uvx upnote-lens-mcp (recommended) or pip install upnote-lens-mcp. Register it in your MCP client (e.g., Claude Desktop) via the provided JSON configuration. Once registered, simply talk to your AI assistant in plain language – the server automatically picks the right tool for searching, reading, listing, or creating notes. No special commands or syntax to memorize.

Key features of Upnote Lens Mcp

• Search notes by keyword across titles and bodies.
• Read full note content (title + body) for analysis or summarization.
• Create new notes from chat using the upnote:// URL scheme.
• List recent notes, notebooks, tags, and notes inside a notebook or tag.
• Open existing notes or notebooks in the UpNote app.
• Override default database path with the UPNOTE_LENS_DB environment variable.

Use cases of Upnote Lens Mcp

• “Summarize my UpNote notes about the Q3 roadmap.”
• “Find notes where I mentioned Postgres tuning and pull out the key points.”
• “What did I write about onboarding last month?”
• “Show me my 5 most recent notes.”
• “Create a note titled ‘Standup 6/4’ with today’s three priorities.”

FAQ from Upnote Lens Mcp

How does Upnote Lens Mcp access my notes?

Reads query the local UpNote SQLite database – the server never modifies the database. Writes use the upnote:// URL scheme and never touch the database.

Can I set tags when creating a note through Upnote Lens Mcp?

No. UpNote’s note/new URL scheme has no tag parameter, and hashtags placed in the body remain plain text. Tags must be added manually in the app after creation.

What are the system requirements for Upnote Lens Mcp?

macOS is fully supported. Windows is best‑effort (database path auto‑detected but not verified). Requires Python 3.10+ (or uv, which brings its own) and the UpNote desktop app installed.

How do I point to a non‑default database location?

Set the environment variable UPNOTE_LENS_DB to the full path of your upnote.sqlite3 file. Default paths are listed for macOS and Windows.

Are reads from the database truly read‑only?

Yes. All read tools (search, get note, list notebooks/tags, etc.) query the local SQLite database in read‑only mode. Writes are handled separately via the URL scheme.