OneNote MCP Server

OneNote MCP サーバー

Microsoft OneNote 用の Model Context Protocol (MCP) サーバー実装です。AI 言語モデルが標準化されたインターフェースを通じて OneNote と連携できるようにします。

機能

ノートブック管理

• すべてのノートブックを一覧表示
• 新しいノートブックを作成
• ノートブックの詳細を取得
• ノートブックを削除

セクション管理

• ノートブック内のセクションを一覧表示
• 新しいセクションを作成
• セクションの詳細を取得
• セクションを削除

ページ管理

• セクション内のページを一覧表示
• HTML コンテンツを含む新しいページを作成
• ページのコンテンツを読み取り
• ページのコンテンツを更新
• ページを削除
• ノートブックをまたいでページを検索

インストール

npm からのインストール (推奨)

npm install -g mcp-server-onenote

このパッケージは 2025 年 4 月 27 日より npm レジストリで利用可能です。

パッケージの実行

インストール後、次のコマンドでパッケージを実行できます:

mcp-server-onenote

または npx を使用する場合:

npx mcp-server-onenote

Smithery 経由でのインストール

Smithery を使用して Claude Desktop 用の OneNote サーバーを自動的にインストールするには:

npx -y @smithery/cli install @modelcontextprotocol/server-onenote --client claude

GitHub からのインストール

npm install -g github:ZubeidHendricks/azure-onenote-mcp-server

設定

次の環境変数を設定してください:

• AZURE_TENANT_ID: Azure テナント ID
• AZURE_CLIENT_ID: Azure アプリケーション (クライアント) ID
• AZURE_CLIENT_SECRET: Azure クライアントシークレット

MCP クライアントでの使用

これを MCP クライアントの設定 (例: Claude Desktop) に追加してください:

{
  "mcpServers": {
    "onenote": {
      "command": "mcp-server-onenote",
      "env": {
        "AZURE_TENANT_ID": "<YOUR_TENANT_ID>",
        "AZURE_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "AZURE_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

Azure アプリの登録

1. Azure Portal に移動し、[アプリの登録] に進みます
2. 新しい登録を作成します
3. Microsoft Graph API のアクセス許可を追加します:
   • Notes.ReadWrite.All
   • Notes.Read.All
4. クライアントシークレットを作成します
5. 設定のためにテナント ID、クライアント ID、クライアントシークレットをコピーします

開発

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Lint
npm run lint

# Run locally
npm start

コントリビューション

このリポジトリへのコントリビューションについては CONTRIBUTING.md を参照してください。

ライセンス

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

変更履歴

0.1.0 (2025-04-27)

• 初回リリース
• OneNote のノートブック、セクション、ページ管理のコア機能
• npm レジストリへ公開

0.1.1 (2025-04-27)

• package.json に実行可能な bin を追加
• npx コマンドが実行する実行可能ファイルを特定できなかった問題を修正
• 明確な実行手順で README を更新