
Upnote Lens Mcp
Connects Claude to your local UpNote SQLite database for reads (search, fetch, list by notebook or tag) and uses the upnote:// URL scheme for writes. You get full note text back, so Claude can summarize across your notes or pull out specifics without you copy-pasting. Creating notes works through x-callback-url, which means you can't set tags programmatically, but everything else (title, markdown body, notebook placement) goes through. Best on macOS where paths are verified; Windows support is best-effort with a guessable default DB location you might need to override. Useful when you want conversational access to your notes without leaving the chat or manually searching the app.
- tools
- 10
- transport
- STDIO
- last updated
- Jun 4, 2026
Tools
10 toolsPublic tool metadata for what this MCP can expose to an agent.
search_notesSubstring search over title/body. Returns id, title, updated time, snippet
Substring search over title/body. Returns id, title, updated time, snippet
No parameter schema in public metadata yet.
get_noteFull title + body text of a note (optionally raw HTML)
Full title + body text of a note (optionally raw HTML)
No parameter schema in public metadata yet.
list_recentMost recently updated notes
Most recently updated notes
No parameter schema in public metadata yet.
list_notebooksNotebooks with note counts and parent
Notebooks with note counts and parent
No parameter schema in public metadata yet.
list_notes_in_notebookNotes inside a notebook
Notes inside a notebook
No parameter schema in public metadata yet.
list_tagsTags with note counts
Tags with note counts
No parameter schema in public metadata yet.
list_notes_by_tagNotes carrying a tag
Notes carrying a tag
No parameter schema in public metadata yet.
create_noteCreate a note. content is Markdown by default. notebook matches by name. Tags can't be set
Create a note. content is Markdown by default. notebook matches by name. Tags can't be set
No parameter schema in public metadata yet.
open_noteOpen an existing note in the app
Open an existing note in the app
No parameter schema in public metadata yet.
open_notebookOpen a notebook in the app
Open a notebook in the app
No parameter schema in public metadata yet.
Sponsors
Readme
upnote-lens-mcp
A hybrid MCP server that lets your AI assistant work with your UpNote notes:
- π Find & search notes by keyword across titles and bodies.
- π Read & summarize β it returns the actual note text, so the AI can summarize, analyze, or answer questions about what you've written.
- βοΈ Create new notes from the chat.
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).
Usage
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:
- "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."
Details
- Repository
- github.com/awesomehye/upnote-lens-mcp
- Category
- Search & Web Crawling
- Package
upnote-lens-mcp- Transport
- STDIO
- Registry
- MCP registry, active