upnote-lens-mcp

upnote-lens-mcp

Un servidor MCP híbrido que permite a tu asistente de IA trabajar con tus notas de UpNote:

• 🔍 Encontrar y buscar notas por palabra clave en títulos y cuerpos.
• 📖 Leer y resumir — devuelve el texto real de la nota, para que la IA pueda resumir, analizar o responder preguntas sobre lo que has escrito.
• ✍️ Crear nuevas notas desde el chat.

En el interior: las lecturas provienen de la base de datos SQLite local de UpNote (solo lectura), por lo que el contenido real regresa como texto; las escrituras pasan por el esquema de URL upnote:// (x-callback-url) y nunca tocan la base de datos.

El lado de escritura (esquema de URL) se basa en chadthornton/upnote-mcp (MIT).

Uso

Una vez registrado, simplemente habla con tu asistente de IA en lenguaje natural: él elige la herramienta adecuada para ti. No hay comandos ni sintaxis que memorizar. Por ejemplo:

• "Resume mis notas de UpNote sobre la hoja de ruta del tercer trimestre."
• "Encuentra notas donde mencioné el ajuste de Postgres y extrae los puntos clave."
• "¿Qué escribí sobre la incorporación el mes pasado?"
• "Muéstrame mis 5 notas más recientes."
• "Crea una nota titulada 'Standup 6/4' con las tres prioridades de hoy."

Leer, buscar, resumir y crear todo ocurre a través de la conversación natural.

Requisitos

• macOS — totalmente compatible y verificado.
• Windows — con el mejor esfuerzo. Las URLs se lanzan a través del manejador de esquema registrado, y la ruta predeterminada de la base de datos se adivina bajo %APPDATA%\UpNote\. Esta ruta no está verificada por el autor — si las lecturas fallan, establece UPNOTE_LENS_DB (ver más abajo).
• Python 3.10+ (o simplemente uv, que trae el suyo propio).
• Aplicación de escritorio de UpNote instalada.

Instalar y registrar

🤖 Deja que la IA lo instale (lo más fácil)

Dale a tu cliente MCP (Claude, etc.) un enlace a llms-install.md y ejecutará los pasos y configurará todo por ti.

🧑 Instálalo tú mismo

Elige la primera opción que se ajuste a lo que ya tienes. Cada opción incluye cómo registrarlo en Claude.

Archivo de configuración de Claude Desktop (referenciado en cada opción):

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Opción 1 — con uv (recomendado)

Requiere uv instalado una vez (brew install uv, o curl -LsSf https://astral.sh/uv/install.sh | sh). Después de eso no hay paso de instalación de paquetes — uvx descarga, almacena en caché y ejecuta upnote-lens-mcp bajo demanda.

Claude Code:

claude mcp add upnote-lens -- uvx upnote-lens-mcp

Claude Desktop:

{ "mcpServers": { "upnote-lens": { "command": "uvx", "args": ["upnote-lens-mcp"] } } }

Opción 2 — con pip (si no tienes uv)

pip install upnote-lens-mcp

Claude Code:

claude mcp add upnote-lens -- upnote-lens-mcp

Claude Desktop:

{ "mcpServers": { "upnote-lens": { "command": "upnote-lens-mcp" } } }

Opción 3 — desde GitHub por HTTPS (si no tienes pip)

Cuando no puedas usar PyPI/pip, instala directamente desde el repositorio con uv. (¿Aún no tienes uv? curl -LsSf https://astral.sh/uv/install.sh | sh.)

Claude Code:

claude mcp add upnote-lens -- uvx --from git+https://github.com/AwesomeHye/upnote-lens-mcp upnote-lens-mcp

Claude Desktop:

{ "mcpServers": { "upnote-lens": { "command": "uvx", "args": ["--from", "git+https://github.com/AwesomeHye/upnote-lens-mcp", "upnote-lens-mcp"] } } }

Herramientas

Leer (consulta la base de datos local → devuelve texto real)

Herramienta	Descripción
search_notes(query, limit=20)	Búsqueda de subcadena en título/cuerpo. Devuelve id, título, hora de actualización, fragmento
get_note(note_id, include_html=False)	Título completo + texto del cuerpo de una nota (opcionalmente HTML sin procesar)
list_recent(limit=20)	Notas actualizadas más recientemente
list_notebooks()	Cuadernos con recuentos de notas y padre
list_notes_in_notebook(notebook_id, limit=50)	Notas dentro de un cuaderno
list_tags()	Etiquetas con recuentos de notas
list_notes_by_tag(tag_title, limit=50)	Notas que llevan una etiqueta

Escribir (esquema de URL upnote://)

Herramienta	Descripción
create_note(title, content, notebook?, markdown=True, new_window=False)	Crea una nota. content es Markdown por defecto. notebook coincide por nombre. Las etiquetas no se pueden establecer (ver más abajo)
open_note(note_id, new_window=False)	Abrir una nota existente en la aplicación
open_notebook(notebook_id)	Abrir un cuaderno en la aplicación

Limitación de etiquetas: el esquema de URL note/new de UpNote no tiene parámetro de etiqueta, y los hashtags colocados en el cuerpo permanecen como texto plano en lugar de convertirse en etiquetas reales (solo se convierten en etiquetas cuando se escriben en el editor). Si necesitas etiquetas, agrégalas manualmente en la aplicación después de crear la nota.

Sobrescribir la ruta de la base de datos

Si la base de datos no está en la ubicación predeterminada (o estás en Windows), apunta a ella con una variable de entorno:

UPNOTE_LENS_DB=/path/to/upnote.sqlite3

Rutas predeterminadas:

• macOS: ~/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3
• Windows (mejor suposición): %APPDATA%\UpNote\upnote.sqlite3

Licencia

MIT. Ver LICENSE para más detalles. Los formatos de esquema de URL y el enfoque de lanzamiento en el lado de escritura están adaptados de chadthornton/upnote-mcp (MIT).