# upnote-lens-mcp

Connects your AI assistant to UpNote: search, read and summarize notes, and create new ones without leaving the chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: AwesomeHye
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AwesomeHye/upnote-lens-mcp
- Updated: 2026-06-04
- HTML: https://affpapa.org/en/nevibecode/mcp/upnote-lens-mcp

## What it does

The server is hybrid by design. Reads hit the local UpNote SQLite database in read-only mode, so the assistant gets the real note text and can summarize it or answer questions about it. Writes take a different route: new notes go out through the `upnote://` URL scheme (x-callback-url) and the database is left untouched.

Tools come in two sets. For reading and search: `search_notes`, `get_note`, `list_recent`, `list_notebooks`, `list_notes_in_notebook`, `list_tags`, `list_notes_by_tag`. For writing and opening: `create_note`, `open_note`, `open_notebook`. There is no syntax to memorize — you describe what you want in plain language.

Tags are the catch. The `note/new` scheme has no tag parameter, and hashtags typed into the body stay plain text instead of becoming real tags, so you add them in the app afterwards. On Windows the database path is guessed under `%APPDATA%\UpNote\` and the author has not verified it; if reads fail, set `UPNOTE_LENS_DB`. You need Python 3.10+ (or `uv`) and the UpNote desktop app installed.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add upnote-lens-mcp -- uvx upnote-lens-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from upnote-lens-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add upnote-lens-mcp -- uvx upnote-lens-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from upnote-lens-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "upnote-lens-mcp": {
            "command": "uvx",
            "args": [
                "upnote-lens-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from upnote-lens-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "upnote-lens-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "upnote-lens-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from upnote-lens-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add upnote-lens-mcp uvx upnote-lens-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from upnote-lens-mcp <command>

## When to use it
- find notes by keyword in titles or bodies
- summarize what you wrote about a project
- create a note from the chat without opening the app
- list notebooks with their note counts
- pull up every note carrying a tag

## Example prompts
- Summarize my UpNote notes about the Q3 roadmap
- Create a note titled 'Standup' with today's three priorities

## Similar
- [video-lens-gallery](https://affpapa.org/en/nevibecode/skills/video-lens-gallery.md) — skill · 438 installs
- [Sequential Thinking Working Notes](https://affpapa.org/en/nevibecode/mcp/sequential-thinking-working-notes.md) — MCP server · ★ 959
- [Hatchdoor](https://affpapa.org/en/nevibecode/mcp/hatchdoor.md) — MCP server · ★ 67
- [product-lens](https://affpapa.org/en/nevibecode/skills/product-lens.md) — skill · 4500 installs
- [claude-lens](https://affpapa.org/en/nevibecode/plugins/claude-lens.md) — plugin · ★ 241

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md