Claudeや他のLLMなどのAI言語モデルがMicrosoft OneNoteとやり取りできるようにするモデルコンテキストプロトコル(MCP)サーバー実装です。

このプロジェクトはZubeid Hendricksによるazure-onenote-mcp-serverをベースにしており、認証の簡素化と使いやすさの向上を目的に修正を加えています。

これは何をする?

このサーバーはAIアシスタントに以下のような機能を提供します:

• OneNoteノートのノート、セクション、ページへのアクセス
• ノートに新しいページを作成すること
• ノートを検索する
• HTMLの書式やテキストを含む完全なノート内容を読むこと
• ノートを直接分析・要約する

これらすべてはAIインターフェースを通じて直接行われ、コンテキストを切り替える必要はありません。

AIアシスタントと連携して使う

カーソルのセットアップ

1. このリポジトリをクローンし、以下のインストール手順に従う
2. MCPサーバーの起動:npm start
3. サーバーをカーソルに登録する:

• カーソル設定を開く(MacではCmd+、WindowsではCtrl+)
• 「MCP」タブへ
• 以下の設定で新しいMCPサーバーを追加:
• 名前:onenote
• コマンド:node
• Args: ["/path/to/your/onenote-mcp.mjs"](絶対経路を使用)

以下がJSONの設定の完全な例です:

4. カーソルの再起動

OneNote MCP Server

A Model Context Protocol (MCP) server implementation that enables AI language models like Claude and other LLMs to interact with Microsoft OneNote.

This project is based on azure-onenote-mcp-server by Zubeid Hendricks, with modifications to simplify authentication and improve usability.

What Does This Do?

This server allows AI assistants to:

• Access your OneNote notebooks, sections, and pages
• Create new pages in your notebooks
• Search through your notes
• Read complete note content, including HTML formatting and text
• Analyze and summarize your notes directly

All of this happens directly through the AI interface without you having to switch contexts.

Using with AI Assistants

Setup for Cursor

1. Clone this repository and follow the installation steps below

2. Start the MCP server: npm start

3. Register the server in Cursor:

   • Open Cursor preferences (Cmd+, on Mac or Ctrl+, on Windows)
   • Go to the “MCP” tab
   • Add a new MCP server with these settings:
     • Name: onenote
     • Command: node
     • Args: ["/path/to/your/onenote-mcp.mjs"] (use absolute path)

   Here’s the complete JSON configuration example:

   {
     "mcpServers": {
       "onenote": {
         "command": "node",
         "args": ["/absolute/path/to/your/onenote-mcp.mjs"],
         "env": {}
       }
     }
   }
   

4. Restart Cursor

5. In Cursor, you can now interact with your OneNote data using natural language:

Can you show me my OneNote notebooks?
Create a new page in my first notebook with a summary of this conversation
Find notes related to "project planning" in my OneNote

The first time you ask about OneNote, the AI will guide you through the authentication process.

Setup for Claude Desktop (or other MCP-compatible assistants)

1. Clone this repository and follow the installation steps below

2. Start the MCP server: npm start

3. In the Claude Desktop settings, add the OneNote MCP server:

   • Name: onenote
   • Command: node
   • Args: ["/path/to/your/onenote-mcp.mjs"] (use absolute path)

   JSON configuration example:

   {
     "mcpServers": {
       "onenote": {
         "command": "node",
         "args": ["/absolute/path/to/your/onenote-mcp.mjs"],
         "env": {}
       }
     }
   }
   

4. You can now ask Claude to interact with your OneNote data

Features

• Authentication with Microsoft OneNote using device code flow (no Azure setup needed)
• List all notebooks, sections, and pages
• Create new pages with HTML content
• Read complete page content, including HTML formatting
• Extract text content for AI analysis and summaries
• Summarize content of all pages in a single operation
• Read full content of all pages in a readable format
• Search across your notes

Installation

Prerequisites

• Node.js 16 or higher (install from nodejs.org)