Microsoft To Do MCP

この MCP (モデルコンテキストプロトコル) サービスを使用すると、AI アシスタントを使用して Microsoft To Do タスクを操作できます。

セットアップ手順

1. 前提条件

Node.js 16以上
npm
Microsoftアカウント
Azure アプリ登録 (以下のセットアップを参照)

2. インストール

このツールのインストールは 2 つの部分から構成されます。

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

ステップ1: パッケージをインストールする

npm install -g @jhirono/todomcp

ステップ2: 認証を設定する

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

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

3. Azure アプリの登録

Azureポータルへアクセス
「アプリ登録」に移動して新しい登録を作成します
アプリケーションに名前を付けます（例：「To Do MCP」）
「サポートされているアカウントの種類」では、ニーズに応じて次のいずれかを選択します。
- この組織ディレクトリ内のアカウントのみ（単一テナント） - 単一組織内で使用
- 任意の組織ディレクトリ内のアカウント (任意の Azure AD ディレクトリ - マルチテナント) - 複数の組織で使用可能
- 組織のディレクトリ内のアカウントと個人の Microsoft アカウント- 仕事用アカウントと個人用アカウントの両方
リダイレクトURIをhttp://localhost:3000/callbackに設定する
アプリを作成したら、「証明書とシークレット」に移動して新しいクライアントシークレットを作成します。
「API 権限」に移動して、次の権限を追加します。
- Microsoft Graph > 委任されたアクセス許可:
  - タスク.読み取り
  - タスク.読み取り/書き込み
  - ユーザー.読み取り
これらの権限に対して「管理者の同意を与える」をクリックします

4. 構成

ルートディレクトリに次の情報を含む.envファイルを作成します。

CLIENT_ID=your_client_id
CLIENT_SECRET=your_client_secret
TENANT_ID=your_tenant_setting
REDIRECT_URI=http://localhost:3000/callback

TENANT_ID オプション:

organizations - マルチテナント組織アカウントの場合（指定されていない場合はデフォルト）
consumers - 個人の Microsoft アカウントのみ
common - 組織アカウントと個人アカウントの両方
your-specific-tenant-id - シングルテナント構成の場合

例:

# For multi-tenant organizational accounts (default)
TENANT_ID=organizations

# For personal Microsoft accounts
TENANT_ID=consumers

# For both organizational and personal accounts
TENANT_ID=common

# For a specific organization tenant
TENANT_ID=00000000-0000-0000-0000-000000000000

Related MCP server: Notion MCP

使用法

完全なワークフロー

トークンを取得するには認証が必要です（クローンしたリポジトリから行う必要があります）
```
npm run auth
```
これにより、Microsoft で認証し、 tokens.jsonファイルを作成するためのブラウザウィンドウが開きます。
MCP 構成ファイルを作成する(クローンしたリポジトリから実行する必要があります)
```
npm run create-config
```
これにより、認証トークンを含むmcp.jsonファイルが作成されます。
グローバルMCP構成を設定する
```
# Copy the mcp.json file to your global Cursor configuration directory
cp mcp.json ~/.cursor/mcp-servers.json
```
これにより、Microsoft To Do MCP をすべてのカーソルプロジェクトで使用できるようになります。
AIアシスタントを使い始める
- カーソルでは、Microsoft To Do コマンドを任意のプロジェクトで直接使用できるようになりました。
- 開始するには、 auth statusやlist up todosなどのコマンドを試してください。

Claude Desktop の構成ファイルは次の場所にあります。

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json
Linux : ~/.config/Claude/claude_desktop_config.json

利用可能なツール

auth-status : 認証ステータスを確認する
get-task-lists : すべてのToDoタスクリストを取得する
create-task-list : 新しいタスクリストを作成する
update-task-list : 既存のタスクリストを更新する
delete-task-list : タスクリストを削除する
get-tasks : リスト内のすべてのタスクを取得する
create-task : 新しいタスクを作成する
update-task : 既存のタスクを更新する
delete-task : タスクを削除する
get-checklist-items : タスクのチェックリスト項目を取得する
create-checklist-item : チェックリスト項目を作成する
update-checklist-item : チェックリスト項目を更新する
delete-checklist-item : チェックリスト項目を削除する

制限事項

APIには適切な認証と権限が必要です
Microsoft のポリシーに従ってレート制限が適用される場合があります

トラブルシューティング

認証の問題

「MailboxNotEnabledForRESTAPI」エラー: これは通常、個人用の Microsoft アカウントを使用していることを意味します。Microsoft To Do API へのアクセスは、Graph API を介した個人アカウントに制限されています。
トークン取得の失敗: .envファイル内のCLIENT_ID 、 CLIENT_SECRET 、およびTENANT_IDが正しいことを確認してください。
アクセス許可の問題: Azure アプリの登録で必要なアクセス許可に対して管理者の同意が付与されていることを確認してください。

アカウントの種類に関する問題

職場/学校アカウント: 通常、To Do API との連携に最適です。TENANT_ID 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)

Microsoft Todo MCP Service