Recordatorio para Windows

Un cliente de escritorio no oficial inspirado en Samsung One UI y un servidor MCP local para leer y escribir datos de Samsung Reminder sin sincronización con Microsoft Reminders.

[!IMPORTANT] Este proyecto experimental no está afiliado, respaldado ni apoyado por Samsung. Depende del comportamiento privado de Samsung Browser y Samsung Cloud que puede cambiar sin previo aviso.

Capturas de pantalla

Todas las imágenes muestran la vista previa del navegador integrado con datos de muestra incluidos.

Related MCP server: Reminders MCP Server

Requisitos

Para una versión precompilada:

• Windows 10 de 64 bits versión 1809 o superior, o Windows 11, en x64 o ARM64. Las compilaciones CI de la versión se construyen y prueban ambas arquitecturas de forma nativa.

• Samsung Browser para Windows instalado usando el instalador oficial de 64 bits de Samsung.

• Una cuenta de Samsung iniciada sesión a través de Samsung Browser. Abra el navegador al menos una vez para que cree el perfil predeterminado.

• Acceso a la red a Samsung Cloud. El instalador también puede descargar Microsoft Edge WebView2 si no está disponible.

Este proyecto actualmente espera las rutas de instalación estándar a nivel de sistema y de perfil predeterminado de Samsung:

• C:\Program Files\Samsung\Internet\Application\samsunginternet.exe

• %LOCALAPPDATA%\Samsung\Internet\User Data\Default

Las ubicaciones personalizadas de instalación y perfil no se detectan actualmente. Samsung Browser debe estar completamente cerrado antes de la primera sincronización. De lo contrario, Chromium redirige el lanzamiento del ayudante al proceso existente sin habilitar el puente localhost privado. Después de que la aplicación haya almacenado en caché una credencial válida, las operaciones normales de Reminder ya no mantienen abierto el navegador.

Samsung actualmente ofrece instaladores evergreen oficiales separados para x64 y ARM64. Este proyecto publica compilaciones de aplicación correspondientes para x64 y ARM64.

Instalar

Descargue el instalador NSIS actual, MSI o ZIP portátil desde GitHub Releases.

Scoop

Este repositorio también es un bucket de Scoop:

scoop bucket add samsung-reminder https://github.com/eliasblume/samsung-reminder-desktop
scoop install samsung-reminder/samsung-reminder

El servidor MCP local es un paquete separado, por lo que las instalaciones solo de escritorio no agregan un binario de línea de comandos a PATH:

scoop install samsung-reminder/samsung-reminder-mcp

Al actualizar desde v0.1.1 o anterior, actualice samsung-reminder antes de instalar el paquete MCP para que Scoop elimine primero el shim MCP previamente empaquetado.

El pipeline de lanzamiento actualiza ambos paquetes Scoop desde sus paquetes separados x64 y ARM64. Las versiones futuras se pueden instalar con:

scoop update samsung-reminder
scoop update samsung-reminder-mcp

Ejecutar desde el código fuente

Las compilaciones desde el código fuente requieren Node.js 22.12 o superior, pnpm 11.17, Rust 1.97.1, los prerrequisitos de Tauri para Windows y las herramientas de compilación de Visual Studio con la carga de trabajo de desarrollo de escritorio con C++.

pnpm install --frozen-lockfile
pnpm tauri:dev

El modo oscuro es el predeterminado en la primera ejecución. El interruptor de apariencia se guarda localmente.

El editor admite listas de Samsung, notas y listas de verificación, importancia, finalización, intensidad de alerta, alertas anticipadas, horarios de todo el día y programados, activadores de lugar, y recurrencia por minuto/hora/día/semana/mes/año. Los colores de lista y los 42 índices de iconos de categoría se sincronizan a través de Samsung Cloud. Las reglas mensuales usan un día del mes y las reglas anuales usan mes más día, coincidiendo con el modelo de datos móvil.

Compilar

pnpm typecheck
pnpm tauri:build
pnpm build:mcp

Tauri produce instaladores NSIS y MSI en src-tauri/target/release/bundle. Consulte RELEASING.md para el proceso de lanzamiento automatizado de SemVer.

Servidor MCP

Instalar el paquete Scoop samsung-reminder-mcp añade samsung-reminder-mcp a PATH. Por lo tanto, una configuración MCP local puede usar:

[mcp_servers.samsung-reminders]
command = "samsung-reminder-mcp"
env = { CDP_ENDPOINT = "http://127.0.0.1:9226" }

Para una compilación desde el código fuente, apunte command a src-tauri/target/release/samsung-reminder-mcp.exe en su lugar.

El servidor stdio expone:

• samsung_reminders_status

• samsung_reminders_list

• samsung_reminder_categories_list

• samsung_reminder_category_create

• samsung_reminder_category_update

• samsung_reminder_category_delete

• samsung_reminders_get

• samsung_reminders_create

• samsung_reminders_update

• samsung_reminders_delete

La eliminación de recordatorios y categorías requiere que confirmId coincida exactamente con el ID de destino. Al eliminar una categoría, primero se mueven sus recordatorios a Mis recordatorios. El estado de MCP omite deliberadamente el correo electrónico de la cuenta de Samsung y la pista de ID de cuenta que la interfaz de escritorio local puede mostrar.

Arquitectura

• React, TanStack DB y TanStack Query para colecciones en vivo, mutaciones optimistas y almacenamiento en caché de operaciones en la nube

• Tailwind CSS, primitivas Radix e iconos Lucide para la interfaz inspirada en One UI

• Tauri 2 y Rust para el shell de escritorio, gestión del ciclo de vida del navegador y cliente directo de Samsung Cloud

• Un pequeño bootstrap de JavaScript evaluado solo dentro de la extensión de Calendario firmada de Samsung

• Administrador de credenciales de Windows más una caché de credenciales en memoria de Rust

• Un binario MCP stdio de Rust hermano que comparte la misma implementación de puente

Privacidad y seguridad

La credencial de Samsung Cloud permanece en Rust y está cifrada para el usuario actual de Windows por el Administrador de credenciales de Windows. Nunca se devuelve a través de React o MCP y no se escribe en registros ni archivos de texto plano. El punto final CDP está restringido a un origen explícito http://127.0.0.1:<port>.

Use Configuración → Desconectar cuenta de Samsung para eliminar la credencial almacenada en caché y volver a la divulgación inicial. Configuración → Borrar todos los datos de la aplicación además limpia la elección de consentimiento almacenada y todos los ajustes locales para un restablecimiento de fábrica completo. Ninguna de las acciones elimina recordatorios almacenados en Samsung Cloud.

El repositorio no contiene APKs de Samsung, código fuente de Samsung descompilado, datos de cuenta de Samsung, cargas útiles de API capturadas, capturas de pantalla de usuarios, tokens de acceso ni material gráfico de Samsung. El ID de extensión, ID de aplicación de la nube, punto final y nombres de tabla en el código fuente son constantes de protocolo, no credenciales de usuario.

Antes de la primera solicitud a la nube, la aplicación muestra una divulgación explícita y requiere aceptación local. Consulte LEGAL.md, PROVENANCE.md y THIRD_PARTY_NOTICES.md para la advertencia de interfaz privada, procedencia de la implementación y avisos de dependencias.

Consulte SECURITY.md antes de reportar una vulnerabilidad. Nunca adjunte tokens, contenido de Reminder, datos del perfil del navegador o volcados de fallos sin editar a un problema público.

Alcance y advertencias

Una actualización de Samsung Browser, la extensión firmada o la API de la nube puede romper este proyecto. La prueba de concepto actual cubre listar, leer, crear, editar, completar, marcar como favorito, listas personalizadas, listas de verificación, recurrencia, alarmas de lugar/hora, alertas anticipadas, recordatorios de todo el día, intensidad de alerta, compartir y eliminación protegida.

La carga de archivos adjuntos, captura de voz, búsqueda en mapa/geocodificación y las plantillas de recordatorios sugeridos de Samsung no están implementadas. Los instaladores de Windows inicialmente no están firmados, por lo que Windows puede mostrar una advertencia de editor. Las sumas de verificación verifican los bytes descargados pero no establecen la identidad del editor.

Licencia

MIT © 2026 eliasblume