MCP Onenote

🚀 MCP OneNote Server

Microsoft OneNote用のModel Context Protocol (MCP) サーバーです。Claude Desktop などのAIエージェントがOneNoteのノートブック、セクション、ページを読み取り、作成し、分析できるようにします。Claude Visionを通じて、画像の内容を自動抽出することも可能です。

🚀 クイックスタート

このサーバーを使うことで、AIエージェントがOneNoteのノートブックやページを操作できるようになります。以下の手順に従ってセットアップしてください。

✨ 主な機能

• 📒 ノートブック、セクション、ページを一覧表示する
• 📄 ページのHTML内容を読み取る
• 🖼️ Claude Visionを通じて埋め込まれた画像からテキストを抽出する（新機能！）
• ✏️ ノートブック、セクション、ページを作成する
• 🔐 Azure AD Device Code Flowを通じた認証

🧰 前提条件

• Node.js 18+
• Microsoftアカウント（個人または職場用）
• AnthropicのAPIキー (console.anthropic.com)

📦 インストール

ステップ1 — プロジェクトをクローンする

git clone https://github.com/FRESHSK/mcp_onenote.git
cd mcp_onenote_01
npm install

ステップ2 — Azure ADアプリを作成する（一度だけ）

この手順では、Microsoft Graph APIにアクセスするための Client ID を取得します。

1. Azure Portal - App Registrations にアクセスします。
2. "New registration" をクリックします。
3. フォームを入力します。
   • Name : MCP OneNote
   • Supported account types : 3番目のオプションを選択します（Multitenant + personal Microsoft accounts）
   • Redirect URI : Public client/native → http://localhost
   • Register をクリックします。
4. パブリックフローを有効にします。
   • 左側のメニュー → Authentication
   • 下にスクロール → Advanced settings
   • Allow public client flows → Yes
   • Save をクリックします。
5. Overview から Application (client) ID をコピーします。

ステップ3 — Microsoft Graph APIの権限を追加する

Azure ADアプリを作成した後、OneNoteにアクセスするために必要な権限を付与する必要があります。

1. Azure Portal で、アプリ登録にアクセスします。
2. 左側のメニュー → API permissions
3. "Add a permission" をクリックします。
4. Microsoft Graph を選択します。
5. Delegated permissions を選択します。
6. 以下の権限を検索してチェックします。 | 権限 | 説明 | |-----------|-------------| | User.Read | ログインしているユーザーのプロファイルを読み取る | | Notes.Read | OneNoteのノートブックを読み取る | | Notes.Create | ノートブックとページを作成する | | Notes.ReadWrite | OneNoteのノートブックを読み取り、変更する |
7. "Add permissions" をクリックします。
8. "Grant admin consent for ..." をクリックします（管理者の場合）。その後、確認します。

ℹ️ 管理者でない場合は、Device Code Flowを通じた初回ログイン時に権限が付与されます。

Azure Portalでの期待される結果：

✅ User.Read              (Delegated) - Granted
✅ Notes.Read             (Delegated) - Granted
✅ Notes.Create           (Delegated) - Granted
✅ Notes.ReadWrite        (Delegated) - Granted

ステップ4 — 環境変数を設定する

cp .env.example .env

.env を編集します。

MICROSOFT_CLIENT_ID=ton-client-id-azure
MICROSOFT_TENANT_ID=common
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx
TOKEN_CACHE_PATH=./token_cache.json

⚠️ .env ファイルを決してコミットしないでください。このファイルは .gitignore に含まれています。

ステップ5 — Microsoftの初回認証

サーバーがOneNoteにアクセスするには、Microsoftのトークンが必要です。一度このスクリプトを実行してください。

node debug_auth.js

ターミナルに以下のように表示されます。

To sign in, use a web browser to open the page
https://microsoft.com/devicelogin and enter the code XXXXXXXX

1. https://microsoft.com/devicelogin を開きます。
2. ターミナルに表示されたコードを入力します。
3. Microsoftアカウントでログインします。
4. token_cache.json ファイルが自動的に作成されます。

✅ この手順は一度だけ必要です。トークンは自動的に更新されます。

ステップ6 — Claude Desktopを設定する

Claude Desktopの claude_desktop_config.json ファイルを編集します。

• Windows : C:\Users\<user>\AppData\Roaming\Claude\claude_desktop_config.json
• Mac : ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "onenote": {
      "command": "node",
      "args": [
        "C:\\chemin\\absolu\\vers\\mcp_onenote_01\\server.js"
      ],
      "env": {
        "TOKEN_CACHE_PATH": "C:\\chemin\\absolu\\vers\\mcp_onenote_01\\token_cache.json"
      }
    }
  }
}

⚠️ TOKEN_CACHE_PATH は絶対パスで指定する必要があります。これにより、Claude Desktopが正しいトークンファイルを見つけることができます。

ステップ7 — Claude Desktopを再起動する

Claude Desktopを閉じて、再度起動します。MCP OneNoteが使用可能になります。

💻 使用例

基本的な使用法

以下のコマンドを使って、OneNoteのノートブックを一覧表示することができます。

node server.js list_notebooks

📚 ドキュメント

利用可能なツール

画像の抽出（Claude Vision）

extract_images: true （デフォルト）の場合、read_content ツールは以下の処理を行います。

1. ページのHTMLを解析する
2. Graph APIを指す <img> タグを検出する
3. 各画像をMicrosoftのBearerトークンで取得する
4. 画像をClaude Visionに送信して、テキスト内容を抽出する
5. テキストと各画像から抽出された内容を返す

この機能を無効にするには、以下のようにします。

read_content(pageId: "...", extract_images: false)

プロジェクトの構造

mcp_onenote_01/
├── server.js                   # メインのMCPサーバー
├── debug_auth.js               # 初期認証用のスクリプト
├── .env                        # 環境変数（コミットしない）
├── .env.example                # 環境変数のテンプレート
├── .gitignore                  # Gitで無視するファイル
├── claude_desktop_config.json  # Claude Desktopの設定例
├── token_cache.json            # MSALトークンのキャッシュ（コミットしない）
└── package.json                # Node.jsの依存関係

主な依存関係

セキュリティ

• キーを含む .env ファイルは .gitignore に含まれています。
• Microsoftのトークンを含む token_cache.json ファイルは .gitignore に含まれています。
• GitHubにAPIキーやトークンを決してコミットしないでください。

トラブルシューティング

Claude DesktopでMCPが応答しない場合 → ログを確認してください：AppData\Roaming\Claude\logs\mcp-server-onenote.log

トークンが期限切れになり、再認証が求められる場合 → claude_desktop_config.json の TOKEN_CACHE_PATH が正しい絶対パスを指していることを確認してください。 → node debug_auth.js を再度実行して、トークンを更新してください。

画像に関する media_type エラーが発生する場合 → APIがサポートしていないタイプの場合、コードは自動的に image/png に正規化します。

📄 ライセンス

MIT