MCP Server Apple Reminders

🚀 Apple 提醒 MCP 服务器

このプロジェクトは、macOS 上の Apple Reminders とネイティブに統合された MCP サーバーを提供します。ユーザーはこのサーバーを通じて、標準化されたインターフェースでリマインダーに対する操作を行うことができます。

English | 简体中文

🚀 クイックスタート

このサーバーを使用することで、macOS の Apple リマインダーとの統合を通じて、リマインダーの操作を簡単に行うことができます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• すべてのリマインダーとリマインダーリストの表示：ユーザーはすべてのリマインダーとそれが属するリストを表示できます。
• 新しいリマインダーの作成：新しいリマインダーを追加でき、タイトル、所属リスト、完了状態、期限、メモをカスタマイズできます。
• リマインダーの完了/未完了のマーキング：特定のリマインダーの完了状態を更新できます。
• メモの追加：リマインダーに追加情報を記録するためのメモを追加できます。
• 期限の設定：各リマインダーに具体的な期限を設定し、タスクの優先順位を管理しやすくします。
• macOS ネイティブ統合：Swift で実装されたローカル統合により、Apple リマインダーサービスとの高い互換性とパフォーマンスを実現します。

📦 インストール

前提条件

1. オペレーティングシステム：このプロジェクトは Apple のリマインダーサービスに依存しているため、macOS が必要です。
2. Node.js バージョン：最新の機能とセキュリティをサポートするため、Node.js 18 以上が必要です。
3. 開発ツール：Swift コードのコンパイルとビルドには、Xcode コマンドラインツールが必要です。

インストールコマンド

npm install -g mcp-server-apple-reminders

📚 ドキュメント

設定ガイド

Cursor での設定

1. Cursor の設定画面を開きます。
2. プラグイン管理セクションに移動します。
3. 新しい MCP サーバー設定を追加し、サーバーアドレスとポートを指定します。
4. Apple リマインダー統合オプションを有効にします。

ChatWise での設定

1. ChatWise の設定メニューにアクセスします。
2. プラグインと拡張機能のタブを選択します。
3. 新しい MCP サービスエントリを追加し、サーバー情報を入力します。
4. Apple リマインダー同期機能を起動します。

Claude Desktop での設定

方法 1: 設定ファイルを直接編集する

1. ターミナルアプリを開きます。
2. 以下のコマンドを入力して、ユーザーディレクトリの設定ファイルにアクセスします。

   cd ~/Library/Application\ Support/Claude/
   

3. config.json ファイルを編集し、以下の内容を追加します。

   "mcpServers": {
     "appleRemindersServer": {
       "url": "http://localhost:8080",
       "enabled": true
     }
   }
   

方法 2: グラフィカルインターフェースで設定する

1. Claude Desktop の設定ウィンドウを開きます。
2. プラグイン管理タブを選択します。
3. 「新しいサーバーを追加」ボタンをクリックし、Apple リマインダー MCP サーバーの情報を入力します。
4. 設定を保存します。

使用例

基本的な使用法

# 例: 新しい買い物リマインダーを作成する
{
  "command": "create_reminder",
  "title": "購入する食料品",
  "list": "家庭",
  "duedate": "2024-03-25T18:00:00Z",
  "notes": "牛乳を忘れないでください"
}

高度な使用法

# 例: 指定されたリスト内の未完了のリマインダーをリストする
{
  "command": "list_reminders",
  "filter": {
    "list": "仕事",
    "showCompleted": false
  }
}

# 例: 特定のリマインダーを完了済みとしてマークする
{
  "command": "update_reminder_status", 
  "reminderId": 123,
  "completed": true
}

開発手順

1. 依存関係のインストール：

   npm install
   

2. Swift 実行ファイルのビルド（Apple リマインダーのローカル統合用）：

   npm run build:swift
   

3. TypeScript コードのコンパイル：

   npm run build:ts
   

4. 開発サーバーの起動：

   npm run start
   

プロジェクト構造

.
├── src/                   # ソースコードディレクトリ
│   ├── index.ts           # アプリケーションのメインエントリポイント
│   ├── server/            # MCP サーバーの実装部分
│   ├── swift/             # ネイティブ Swift 統合コード
│   │   ├── bin/           # コンパイルされた Swift 実行可能ファイル
│   │   └── src/           # Swift ソースコードファイル
│   ├── tools/             # CLI ツールと補助スクリプト
│   ├── types/             # TypeScript 型定義
│   └── utils/             # 補助関数とツールモジュール
├── dist/                  # コンパイル後の出力ディレクトリ（本番環境用）
└── package.json           # プロジェクトの依存関係管理ファイル

注意事項

⚠️ 重要提示

• 権限の問題：macOS では、アプリケーションが Apple リマインダーサービスにアクセスする権限を持っていることを確認してください。必要に応じて、システム設定で許可を付与する必要があります。
• 互換性の確認：プラグインの互換性を検証するため、異なる macOS バージョンでテストすることをお勧めします。
• データ同期：ローカルのリマインダーデータベースを直接操作するため、他のクライアント（iCloud など）とのデータの同期が取れない場合があります。定期的に手動で同期することを確認してください。

貢献ガイド

コードの貢献や問題の報告、提案は大歓迎です。具体的な協力方法や規則については、プロジェクトリポジトリの CONTRIBUTING.md ファイルを参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

以上の手順と設定に従うことで、macOS で Apple リマインダーサービスと MCP サーバーを円滑に統合し、タスク管理の効率を向上させることができます。