# upnote-lens-mcp

Даёт ИИ-ассистенту доступ к заметкам UpNote: поиск, чтение, пересказ и создание новых записей прямо из диалога.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Автор: AwesomeHye
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/AwesomeHye/upnote-lens-mcp
- Обновлён: 2026-06-04
- HTML: https://affpapa.org/nevibecode/mcp/upnote-lens-mcp

## Что делает

Сервер гибридный. Чтение идёт из локальной базы UpNote в SQLite, причём только на чтение, поэтому ассистент получает настоящий текст заметки и может её пересказать или ответить по содержимому. Запись работает иначе: новые заметки создаются через схему `upnote://` (x-callback-url), база при этом не трогается.

Инструментов две группы. Поиск и чтение: `search_notes`, `get_note`, `list_recent`, `list_notebooks`, `list_notes_in_notebook`, `list_tags`, `list_notes_by_tag`. Создание и открытие: `create_note`, `open_note`, `open_notebook`. Отдельных команд запоминать не нужно — достаточно сказать, что вам нужно.

Теги при создании заметки поставить не получится: у схемы `note/new` нет параметра тега, а хештеги в теле остаются обычным текстом. Если теги нужны, добавьте их в приложении вручную. На Windows путь к базе угадывается под `%APPDATA%\UpNote\` и автором не проверен — при сбое чтения укажите `UPNOTE_LENS_DB`. Нужны Python 3.10+ (или `uv`) и установленное десктопное приложение UpNote.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add upnote-lens-mcp -- uvx upnote-lens-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from upnote-lens-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add upnote-lens-mcp -- uvx upnote-lens-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from upnote-lens-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "upnote-lens-mcp": {
            "command": "uvx",
            "args": [
                "upnote-lens-mcp"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from upnote-lens-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "upnote-lens-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "upnote-lens-mcp"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from upnote-lens-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add upnote-lens-mcp uvx upnote-lens-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from upnote-lens-mcp <команда>

## Когда брать
- найти заметки по ключевому слову в заголовке или теле
- пересказать содержимое заметок по теме проекта
- создать заметку из чата, не открывая приложение
- посмотреть список блокнотов и число заметок в каждом
- вытащить заметки с определённым тегом

## Примеры запросов агенту
- Перескажи мои заметки UpNote про план на квартал
- Найди заметки, где я писал про настройку Postgres, и выдели главное
- Создай заметку «Стендап» с тремя приоритетами на сегодня

## Похожие
- [video-lens-gallery](https://affpapa.org/nevibecode/skills/video-lens-gallery.md) — скилл · 438 установок
- [Sequential Thinking Working Notes](https://affpapa.org/nevibecode/mcp/sequential-thinking-working-notes.md) — MCP-сервер · ★ 959
- [Hatchdoor](https://affpapa.org/nevibecode/mcp/hatchdoor.md) — MCP-сервер · ★ 67
- [Fjord](https://affpapa.org/nevibecode/mcp/fjord.md) — MCP-сервер · ★ 5
- [product-lens](https://affpapa.org/nevibecode/skills/product-lens.md) — скилл · 4500 установок
- [claude-lens](https://affpapa.org/nevibecode/plugins/claude-lens.md) — плагин · ★ 241

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md