Reminder for Windows

Samsung One UI にインスパイアされた非公式のデスクトップクライアントおよびローカル MCP サーバーです。Microsoft Reminders の同期を介さずに Samsung Reminder データの読み書きを行います。

[!IMPORTANT] この実験的プロジェクトは、Samsung とは提携、承認、サポートされていません。これは、予告なく変更される可能性のある Samsung Browser および Samsung Cloud の非公開の動作に依存しています。

スクリーンショット

すべての画像は、組み込みのブラウザプレビューとバンドルされたサンプルデータを示しています。

Related MCP server: Reminders MCP Server

必要条件

プリビルドリリースの場合:

• 64ビット Windows 10 バージョン 1809 以降、または Windows 11 (x64 または ARM64)。リリース CI では両方のアーキテクチャをネイティブでビルドおよびテストしています。

• Samsung Browser for Windows が Samsung 公式の 64ビットインストーラでインストールされていること。

• Samsung Browser にサインインしている Samsung アカウント。ブラウザを少なくとも一度開いて、デフォルトプロファイルを作成してください。

• Samsung Cloud へのネットワークアクセス。インストーラは、Microsoft Edge WebView2 が利用できない場合にダウンロードすることもあります。

このプロジェクトは現在、Samsung の標準的なシステム全体へのインストールとデフォルトのプロファイルパスを想定しています:

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

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

カスタムインストール場所やプロファイルの場所は現在検出されません。初回同期の前に Samsung Browser を完全に閉じる必要があります。そうしないと、Chromium はプライベートな localhost ブリッジを有効にせずに、ヘルパーの起動を既存のプロセスにルーティングします。アプリが有効な資格情報をキャッシュした後は、通常の Reminder 操作でブラウザを開いたままにする必要はありません。

Samsung は現在、別々の公式 x64 および ARM64 エバーグリーンインストーラを提供しています。このプロジェクトは、対応する x64 および ARM64 のアプリビルドを公開しています。

インストール

最新の NSIS インストーラ、MSI、またはポータブル ZIP を GitHub Releases からダウンロードしてください。

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、Tauri prerequisites for Windows、および C++ を使用したデスクトップ開発ワークロードを備えた Visual Studio Build Tools が必要です。

pnpm install --frozen-lockfile
pnpm tauri:dev

ダークモードが初回実行時のデフォルトです。外観の切り替えはローカルに保存されます。

エディタは、Samsung のリスト、メモ、チェックリスト、重要度、完了、アラート強度、早期アラート、終日および時刻指定のスケジュール、場所トリガー、分/時/日/週/月/年の繰り返しをサポートしています。リストの色と全42のカテゴリアイコンインデックスは Samsung Cloud を介して同期されます。月次ルールは日付を使用し、年次ルールは月と日を使用して、モバイルのデータモデルと一致します。

ビルド

pnpm typecheck
pnpm tauri:build
pnpm build:mcp

Tauri は src-tauri/target/release/bundle 以下に NSIS および MSI インストーラを生成します。自動化された 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

リマインダーとカテゴリの削除には、confirmId がターゲットIDと完全に一致する必要があります。カテゴリを削除すると、そのリマインダーは最初に「My reminders」に移動されます。MCP ステータスは、ローカルデスクトップUIが表示できる Samsung アカウントのメールアドレスとアカウントIDのヒントを意図的に省略しています。

アーキテクチャ

• React、TanStack DB、TanStack Query によるライブコレクション、楽観的ミューテーション、クラウド操作のキャッシュ

• Tailwind CSS、Radix プリミティブ、Lucide アイコンによる One UI にインスパイアされたインターフェース

• Tauri 2 と Rust によるデスクトップシェル、ブラウザライフサイクル管理、直接の Samsung Cloud クライアント

• Samsung の署名付き 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 に保存されているリマインダーは削除しません。

リポジトリには、Samsung APK、逆コンパイルされた Samsung ソース、Samsung アカウントデータ、キャプチャされた API ペイロード、ユーザーのスクリーンショット、アクセストークン、または Samsung のアートワークは含まれていません。ソース内の拡張 ID、クラウドアプリ ID、エンドポイント、テーブル名は、ユーザー資格情報ではなくプロトコル定数です。

最初のクラウドリクエストの前に、アプリは明示的な開示を表示し、ローカルでのオプトインを要求します。プライベートインターフェースの注意事項、実装の出所、依存関係の通知については、LEGAL.md、PROVENANCE.md、THIRD_PARTY_NOTICES.md を参照してください。

脆弱性を報告する前に、SECURITY.md を参照してください。トークン、Reminder の内容、ブラウザプロファイルデータ、または編集されていないクラッシュダンプを公開イシューに添付しないでください。

範囲と注意事項

Samsung Browser、署名付き拡張機能、または Cloud API の更新により、このプロジェクトが動作しなくなる可能性があります。現在の概念実証は、一覧表示、読み取り、作成、編集、完了、お気に入り、カスタムリスト、チェックリスト、繰り返し、場所/時間アラーム、早期アラート、終日リマインダー、アラート強度、共有、保護された削除をカバーしています。

添付ファイルのアップロード、音声キャプチャ、マップ検索/ジオコーディング、Samsung の推奨リマインダーテンプレートは実装されていません。Windows インストーラは当初署名されていないため、Windows に発行元の警告が表示される場合があります。チェックサムはダウンロードしたバイトを検証しますが、発行元の身元を確認するものではありません。

ライセンス

MIT © 2026 eliasblume