Todomcp

🚀 マイクロソフトTo Do MCPサービス説明

このMCP（モデルコンテキストプロトコル）サービスは、AIアシスタントを通じてマイクロソフトTo Doタスクとやり取りすることを可能にします。

🚀 クイックスタート

このMCPサービスを使うことで、AIアシスタントを介してマイクロソフトTo Doのタスクとやり取りできます。以下に、サービスのインストールと使用方法を説明します。

✨ 主な機能

• AIアシスタントを通じたマイクロソフトTo Doタスクとの対話
• タスクの一覧表示、詳細取得、作成、更新、削除
• カテゴリの一覧表示、詳細取得、作成、更新、削除

📦 インストール

1. 前提条件

• Node.js 16以上
• npm
• マイクロソフトアカウント
• Azureアプリケーション登録（下記の設定説明を参照）

2. インストール手順

このツールのインストールには、2つの部分が含まれます。

1. パッケージのインストール
2. 認証の設定（リポジトリのクローンが必要）

ステップ1：パッケージのインストール

npm install -g @jhirono/todomcp

ステップ2：認証の設定

パッケージをグローバルにインストールした場合でも、認証プロセスを完了するためにリポジトリをクローンする必要があります。

git clone https://github.com/jhirono/todoMCP.git
cd todoMCP
npm install

3. Azureアプリケーション登録

1. Azureポータルにアクセスします。
2. 「アプリケーション登録」に移動し、新しい登録を作成します。
3. アプリケーションに名前を付けます（例：「To Do MCP」）。
4. 「サポートされるアカウントの種類」について、以下のオプションから必要に応じて選択します。
   • 組織ディレクトリ内のアカウントのみ (シングルテナント) - 単一組織内での使用
   • 任意の組織ディレクトリ内のアカウント (マルチテナント) - 複数組織間での使用
   • 職場または学校アカウント - 教育または企業環境での使用
5. 「アプリケーション認証」セクションで、セッションとAPIのアクセス許可を構成します。
6. クライアントシークレットを作成して、CLIENT_SECRETの値を取得します。

4. 設定ガイド

プロジェクトのルートディレクトリに.envファイルを作成し、以下の内容を追加します。

CLIENT_ID=your_client_id_here
CLIENT_SECRET=your_client_secret_here
TENANT_ID=your_tenant_id_here

your_client_id_here、your_client_secret_here、your_tenant_id_hereを、Azure登録から取得した実際の値に置き換えてください。

5. 使用方法

インストールが完了したら、以下のコマンドでMCPツールを使用できます。

mcp --help

これにより、利用可能なすべてのコマンドとその詳細オプションが表示されます。特定のコマンドの使用方法については、ドキュメントを参照してください。

💻 使用例

基本的な使用法

# 全てのタスクを取得
mcp list-tasks

高度な使用法

# 特定のタスクを更新
mcp update-task --task-id=123 --title="新しいタイトル"

📚 ドキュメント

利用可能なツール

以下は、使用できるコマンドの完全なリストです。

• list-tasks：すべてのタスクを取得
• get-task：単一のタスクの詳細情報を取得
• create-task：新しいタスクを作成
• update-task：既存のタスクを更新
• delete-task：指定されたタスクを削除
• list-categories：すべてのカテゴリを取得
• get-category：単一のカテゴリの詳細情報を取得
• create-category：新しいカテゴリを作成
• update-category：既存のカテゴリを更新
• delete-category：指定されたカテゴリを削除

制限事項と注意事項

• APIには、正しい認証とアクセス許可が必要です。
• マイクロソフトのポリシーにより、レート制限が適用される場合があります。

トラブルシューティング

認証問題

• "MailboxNotEnabledForRESTAPI" エラー：通常、個人用のマイクロソフトアカウントを使用していることを示します。Graph APIを介したTo Do APIへのアクセスは、個人用アカウントでは制限されています。
• トークン取得失敗：.envファイル内のCLIENT_ID、CLIENT_SECRET、TENANT_IDが正しいことを確認してください。
• アクセス許可問題：Azureアプリケーション登録で必要な管理同意のアクセス許可が付与されていることを確認してください。

アカウントタイプの問題

• 職場/学校アカウント：これらは通常、To Do APIの使用に最適です。TENANT_ID=organizationsまたは特定のテナントIDを使用してください。
• 個人用アカウント：これらはTo Do APIへのアクセスが制限されています。個人用アカウントを使用する場合は、TENANT_ID=consumersまたはTENANT_ID=commonを試してみてください。

認証ステータスの確認

auth-statusツールを使用して認証ステータスを確認するか、トークンの有効期限を確認できます。

cat tokens.json | grep expiresAt

タイムスタンプを読みやすい日付に変換するには、次のコマンドを使用します。

date -r $(echo "$(cat tokens.json | grep expiresAt | cut -d ":" -f2 | cut -d "," -f1) / 1000" | bc)