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)