Windows용 Reminder

비공식 Samsung One UI 스타일 데스크톱 클라이언트 및 로컬 MCP 서버로, Microsoft Reminders 동기화 없이 삼성 Reminder 데이터를 읽고 쓸 수 있습니다.

[!IMPORTANT] 이 실험적인 프로젝트는 삼성과 제휴, 보증 또는 지원되지 않습니다. 이 프로젝트는 예고 없이 변경될 수 있는 비공개 Samsung Browser 및 Samsung Cloud 동작에 의존합니다.

스크린샷

모든 이미지는 내장 브라우저 미리보기에 번들된 샘플 데이터를 표시합니다.

Related MCP server: Reminders MCP Server

요구 사항

사전 빌드된 릴리스의 경우:

• 64비트 Windows 10 버전 1809 이상, 또는 Windows 11, x64 또는 ARM64. 릴리스 CI는 두 아키텍처를 모두 기본으로 빌드하고 테스트합니다.

• 삼성 공식 64비트 설치 프로그램을 사용하여 설치된 Windows용 Samsung Browser.

• Samsung Browser를 통해 로그인된 Samsung 계정. 기본 프로필을 생성하려면 브라우저를 한 번 이상 열어야 합니다.

• Samsung Cloud에 대한 네트워크 액세스. 설치 프로그램은 Microsoft Edge WebView2를 사용할 수 없는 경우 다운로드할 수도 있습니다.

이 프로젝트는 현재 삼성의 표준 시스템 전체 설치 및 기본 프로필 경로를 예상합니다:

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

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

사용자 지정 설치 및 프로필 위치는 현재 감지되지 않습니다. 첫 번째 동기화 전에 Samsung Browser를 완전히 닫아야 합니다. 그렇지 않으면 Chromium이 비공개 로컬호스트 브리지를 활성화하지 않고 도우미 실행을 기존 프로세스로 라우팅합니다. 앱이 유효한 자격 증명을 캐시한 후에는 일반 Reminder 작업이 더 이상 브라우저를 열어 두지 않습니다.

삼성은 현재 별도의 공식 x64 및 ARM64 에버그린 설치 프로그램을 제공합니다. 이 프로젝트는 해당하는 x64 및 ARM64 앱 빌드를 게시합니다.

설치

GitHub Releases에서 최신 NSIS 설치 프로그램, MSI 또는 포터블 ZIP을 다운로드하세요.

Scoop

이 리포지토리는 또한 Scoop 버킷입니다:

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

로컬 MCP 서버는 별도 패키지이므로 데스크톱 전용 설치는 PATH에 명령줄 바이너리를 추가하지 않습니다:

scoop install samsung-reminder/samsung-reminder-mcp

v0.1.1 또는 이전 버전에서 업그레이드할 때는 MCP 패키지를 설치하기 전에 samsung-reminder를 업데이트하여 Scoop이 이전에 번들된 MCP 심을 먼저 제거하도록 하세요.

릴리스 파이프라인은 별도의 x64 및 ARM64 번들에서 두 Scoop 패키지를 모두 업데이트합니다. 이후 릴리스는 다음 명령으로 설치할 수 있습니다:

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

소스에서 실행

소스 빌드에는 Node.js 22.12 이상, pnpm 11.17, Rust 1.97.1, Windows용 Tauri 필수 구성 요소 및 C++ 워크로드를 사용한 데스크톱 개발이 포함된 Visual Studio Build Tools가 필요합니다.

pnpm install --frozen-lockfile
pnpm tauri:dev

다크 모드는 첫 실행 기본값입니다. 모양 전환은 로컬에 저장됩니다.

편집기는 삼성 목록, 메모 및 체크리스트, 중요도, 완료, 알림 강도, 조기 알림, 종일 및 시간 지정 일정, 장소 트리거, 분/시간/일/주/월/년 반복을 지원합니다. 목록 색상과 모든 42개 카테고리 아이콘 인덱스는 Samsung Cloud를 통해 동기화됩니다. 월별 규칙은 일(day of month)을 사용하고 연간 규칙은 월(month)과 일(day)을 사용하여 모바일 데이터 모델과 일치합니다.

빌드

pnpm typecheck
pnpm tauri:build
pnpm build:mcp

Tauri는 NSIS 및 MSI 설치 프로그램을 src-tauri/target/release/bundle 아래에 생성합니다. 자동화된 SemVer 릴리스 프로세스는 RELEASING.md를 참조하세요.

MCP 서버

samsung-reminder-mcp Scoop 패키지를 설치하면 samsung-reminder-mcp가 PATH에 추가됩니다. 따라서 로컬 MCP 구성은 다음을 사용할 수 있습니다:

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

소스 빌드의 경우 command를 src-tauri/target/release/samsung-reminder-mcp.exe로 지정하세요.

stdio 서버는 다음을 노출합니다:

• 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

Reminder 및 카테고리 삭제는 confirmId가 대상 ID와 정확히 일치해야 합니다. 카테고리를 삭제하면 먼저 해당 Reminder가 내 Reminder로 이동됩니다. MCP 상태는 로컬 데스크톱 UI가 표시할 수 있는 Samsung 계정 이메일 및 계정 ID 힌트를 의도적으로 생략합니다.

아키텍처

• React, TanStack DB 및 TanStack Query를 사용한 실시간 컬렉션, 낙관적 변이 및 클라우드 작업 캐싱

• Tailwind CSS, Radix 프리미티브 및 Lucide 아이콘을 사용한 One UI 스타일 인터페이스

• Tauri 2 및 Rust를 사용한 데스크톱 셸, 브라우저 수명 주기 관리 및 직접 Samsung Cloud 클라이언트

• 삼성의 서명된 Calendar 확장 프로그램 내에서만 평가되는 소규모 JavaScript 부트스트랩

• Windows Credential Manager 및 인메모리 Rust 자격 증명 캐시

• 동일한 브리지 구현을 공유하는 자매 Rust stdio MCP 바이너리

개인 정보 보호 및 보안

Samsung Cloud 자격 증명은 Rust에 남아 있으며 Windows Credential Manager에 의해 현재 Windows 사용자에 대해 암호화됩니다. React 또는 MCP를 통해 반환되지 않으며 로그나 일반 텍스트 파일에 기록되지 않습니다. CDP 엔드포인트는 명시적인 http://127.0.0.1:<port> 출처로 제한됩니다.

설정 → Samsung 계정 연결 해제를 사용하여 캐시된 자격 증명을 제거하고 첫 실행 공개 화면으로 돌아갑니다. 설정 → 모든 앱 데이터 지우기는 저장된 동의 선택 및 모든 로컬 설정을 추가로 지워 완전한 공장 초기화를 수행합니다. 두 작업 모두 Samsung Cloud에 저장된 Reminder를 삭제하지 않습니다.

리포지토리에는 Samsung APK, 디컴파일된 Samsung 소스, Samsung 계정 데이터, 캡처된 API 페이로드, 사용자 스크린샷, 액세스 토큰 또는 Samsung 아트워크가 포함되어 있지 않습니다. 소스의 확장 프로그램 ID, Cloud 앱 ID, 엔드포인트 및 테이블 이름은 사용자 자격 증명이 아닌 프로토콜 상수입니다.

첫 번째 클라우드 요청 전에 앱은 명시적인 공개를 표시하고 로컬 동의가 필요합니다. 비공개 인터페이스 주의 사항, 구현 출처 및 종속성 고지 사항은 LEGAL.md, PROVENANCE.md 및 THIRD_PARTY_NOTICES.md를 참조하세요.

취약점을 보고하기 전에 SECURITY.md를 참조하세요. 공개 이슈에 토큰, Reminder 내용, 브라우저 프로필 데이터 또는 편집되지 않은 크래시 덤프를 절대 첨부하지 마세요.

범위 및 주의 사항

Samsung Browser, 서명된 확장 프로그램 또는 Cloud API 업데이트로 인해 이 프로젝트가 중단될 수 있습니다. 현재 개념 증명은 목록 보기, 읽기, 생성, 편집, 완료, 즐겨찾기, 사용자 지정 목록, 체크리스트, 반복, 장소/시간 알람, 조기 알림, 종일 Reminder, 알림 강도, 공유 및 보호된 삭제를 다룹니다.

첨부 파일 업로드, 음성 캡처, 지도 검색/지오코딩 및 삼성의 제안된 Reminder 템플릿은 구현되지 않았습니다. Windows 설치 프로그램은 초기에 서명되지 않았으므로 Windows에 게시자 경고가 표시될 수 있습니다. 체크섬은 다운로드된 바이트를 확인하지만 게시자 신원을 설정하지는 않습니다.

라이선스

MIT © 2026 eliasblume