upnote-mcp

upnote-mcp es un servidor MCP de solo lectura para leer datos locales de UpNote desde SQLite a través de stdio.

Este es un proyecto no oficial y no está afiliado, respaldado ni mantenido por UpNote.

Características

• search_notes: buscar notas por título, cuerpo del texto o resumen

• list_recent_notes: listar las notas más recientemente actualizadas

• list_notes_this_week: listar notas actualizadas durante la semana actual

• list_notes_this_month: listar notas actualizadas durante el mes actual

• find_notes: combinar filtros de período, palabra clave y etiqueta en una sola llamada

• open_note: abrir una nota en la aplicación UpNote por ID de nota

• get_note: obtener el contenido completo de una nota por ID de nota

• open_notebook: abrir un bloc de notas en la aplicación UpNote por ID de bloc

• list_notebooks: listar blocs de notas con conteos de notas

• create_note: crear una nueva nota a través del esquema de URL oficial de UpNote

• list_tags: listar etiquetas

• search_by_tag: listar notas para una etiqueta

Este proyecto es intencionalmente de solo lectura. No escribe en la base de datos de UpNote. La creación segura de notas y las acciones de apertura se realizan a través del esquema de URL oficial de UpNote en lugar de escrituras directas en la base de datos.

Related MCP server: upnote-lens-mcp

Nombre del Paquete

Este paquete está preparado para publicarse como @bellx2/upnote-mcp.

Requisitos

• macOS

• bun instalado en la máquina que ejecuta el servidor

• Aplicación de escritorio UpNote instalada

• Ruta predeterminada de la base de datos de UpNote:

~/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3

Si tu base de datos está en otro lugar, configura UPNOTE_DB.

Instalación

bun install

Ejecución

bun run start

Para uso normal, prefiere el paquete publicado:

bunx @bellx2/upnote-mcp

o:

npx @bellx2/upnote-mcp

El soporte de npx aún depende de que bun esté instalado, porque este paquete usa APIs específicas de Bun como bun:sqlite.

Para desarrollo con vigilancia de archivos:

bun run dev

Variables de Entorno

• UPNOTE_DB: ruta absoluta a upnote.sqlite3

Ejemplo:

export UPNOTE_DB="$HOME/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3"

Permisos

En la primera ejecución, tu cliente MCP puede mostrar solicitudes de permiso para la ejecución de comandos y el acceso a archivos locales.

Esto es esperado porque el servidor:

• se lanza a través de bun

• lee tu base de datos local de UpNote SQLite

• puede abrir la aplicación UpNote para open_note, open_notebook o create_note

Si deniegas estos permisos, la búsqueda y recuperación de notas no funcionarán. Después de conceder acceso, es posible que necesites reiniciar el servidor MCP en Cursor o Claude Desktop.

Ejemplo de Configuración MCP

Recomendado: paquete publicado

Cursor

{
  "mcpServers": {
    "upnote": {
      "command": "bunx",
      "args": ["@bellx2/upnote-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "upnote": {
      "command": "bunx",
      "args": ["@bellx2/upnote-mcp"]
    }
  }
}

Clon de desarrollo local

Cursor

{
  "mcpServers": {
    "upnote": {
      "command": "/absolute/path/to/bun",
      "args": ["run", "/absolute/path/to/upnote-mcp/src/index.ts"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "upnote": {
      "command": "/absolute/path/to/bun",
      "args": ["run", "/absolute/path/to/upnote-mcp/src/index.ts"]
    }
  }
}

Flujos de Trabajo de Ejemplo

Prueba indicaciones como:

• Buscar en UpNote "viaje" y muéstrame el primer resultado

• Muéstrame mis 10 notas más recientes de UpNote

• Muéstrame las notas de esta semana

• Muéstrame las notas de este mes

• Encontrar las notas de IA de esta semana

• Encontrar las notas de este mes etiquetadas como reunión

• Listar mis etiquetas de UpNote y abrir la nota que coincida con la etiqueta "reunión"

• Encontrar notas sobre "lanzamiento", resumirlas y crear una nueva nota de UpNote con el resumen

• Listar blocs de notas y abrir el llamado "Investigación"

Referencia de Herramientas

search_notes

Entrada:

{
  "query": "travel",
  "limit": 5
}

list_recent_notes

Entrada:

{
  "limit": 10
}

list_notes_this_week

Entrada:

{
  "limit": 20
}

list_notes_this_month

Entrada:

{
  "limit": 20
}

find_notes

Entrada:

{
  "period": "this_week",
  "query": "AI",
  "limit": 10
}

O:

{
  "period": "this_month",
  "tag": "meeting",
  "limit": 10
}

get_note

Entrada:

{
  "id": "019fd239-a98a-742b-b75b-cee66e7aa830"
}

open_note

Entrada:

{
  "id": "019fd239-a98a-742b-b75b-cee66e7aa830"
}

open_notebook

Entrada:

{
  "id": "3f03c742-1270-4d35-a5bc-c7d98580d6fc"
}

list_notebooks

Entrada:

{}

list_tags

Entrada:

{}

search_by_tag

Entrada:

{
  "tag": "meeting",
  "limit": 5
}

create_note

Entrada:

{
  "title": "Meeting Notes",
  "text": "# Summary\n\nDraft created by MCP.",
  "markdown": true,
  "newWindow": false
}

Verificación

bun run check
bun run smoke

README en Japonés

El README en japonés anterior está disponible en README_ja.md.