mstodo-bridge

Claude で Microsoft To Do を直接管理。 MCP サーバーで、インストールは設定不要、ログインは会話の中で完結します。

インストール

1. Claude Code にインストール

claude mcp add -s user taskbridge -- npx -y mstodo-bridge

-s user でグローバルに有効になります(すべてのプロジェクトで利用可能)。完了後、Claude Code セッションを再起動してください。

2. または MCP 設定ファイルに書き込む

Claude Desktop:設定ファイルを編集します(Windows %APPDATA%\Claude\claude_desktop_config.json、macOS ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "taskbridge": {
      "command": "npx",
      "args": ["-y", "mstodo-bridge"]
    }
  }
}

Cursor / その他の MCP クライアント:同様に npx -y mstodo-bridge を stdio コマンドとして追加します。保存後、クライアントを再起動してください。

3. または Web サービスを起動する

特定のクライアントに紐付ける必要はなく、管理コンソール付きのサービスとして単独で実行することもできます:

npx mstodo-bridge --http        # 管理台 http://127.0.0.1:46377/admin

初回起動時に管理パスワードと MCP Bearer トークンが表示されます(一度だけ表示)。他のクライアントは http://<host>:46377/mcp(Bearer 認証)経由でリモート接続できます。サーバー/Hugging Face Spaces へのデプロイは後述の「デプロイ」を参照してください。

Related MCP server: Remote MCP Entra ID Todo

ログイン

方法1:Claude で(推奨)

クライアントを再起動したら、Claude に直接こう伝えます:

Microsoft To Do に接続して

Claude が login ツールを呼び出し、認証リンクを返します → ブラウザで開く → マイクロソフトの個人アカウントで同意 → 自動的に再接続されて完了します。以後、自然言語で操作できます:

リストを見せて · X を「研究学術」に追加、金曜日締め切り · 「論文」を含むタスクを検索 · 3 番目を完了

方法2:Web 管理コンソール経由

npx mstodo-bridge --http --open

1. ブラウザで管理コンソールを開き、起動時に表示された管理パスワードを入力してログインします;

2. Microsoft To Do カードの「アカウント接続」をクリックし、ブラウザで認証が完了すると自動的に戻ります;

3. リモート環境(ブラウザとサーバーが別のマシンにある場合)では、認証後に localhost へリダイレクトされエラーになります —— これは想定された動作です。アドレスバーの完全な URL をカードの「接続完了」入力欄に貼り付けてください。

どちらの方法で生成される資格情報も完全に同じです(~/.mstodo-bridge)。どちらを使っても構いません。

MCP ツール(15 個)

アカウントとログイン

リスト

タスクの読み取り

タスクの書き込み

provider? とあるパラメータはシングルアカウントモードでは省略可能です。

デプロイ

PORT=7860 HOST=0.0.0.0 PUBLIC_BASE_URL=https://<user>-<space>.hf.space npx mstodo-bridge --http

セキュリティ

資格情報はローカルのみに保存(~/.mstodo-bridge、0600 パーミッション)。パスワードとトークンは scrypt ハッシュのみを保存し、定時間比較で検証。OAuth は全工程で PKCE + 使い捨て state。管理コンソールは厳格な CSP、ログインはレート制限付き。更新トークンが無効になった場合は自動的にクリアし、再接続を案内します。

開発

git clone https://github.com/WNJXYK/MSTodo-Bridge && cd MSTodo-Bridge
npm install && npm run build && npm test

Issue と PR は GitHub へお寄せください。

License

MIT