OneNote MCP Server - это мощный сервер протокола контекста модели (MCP), который позволяет языковым моделям ИИ (LLM), таким как Claude и другим помощникам ИИ, безопасно взаимодействовать с данными Microsoft OneNote. Он позволяет читать, писать, искать и всесторонне редактировать записные книжки, разделы и страницы OneNote непосредственно через интерфейс AI.

Этот сервер предоставляет богатый набор инструментов для расширенного управления OneNote, включая надежное извлечение текста, обработку HTML-контента и мелкозернистую обработку страниц.

Особенности

*** Постановление:** Безопасный поток кода устройства для доступа Microsoft Graph API. Читать Операции:

• Перечислите тетради, разделы и страницы.
• Поиск страниц по заголовку.
• Получить содержимое страницы в различных форматах (полный HTML, читаемый текст, резюме). **Письмо и редактирование: ** Создавайте новые страницы OneNote с пользовательским HTML или разметкой. Обновление всего содержимого страницы, сохранение или замена заголовка.
• Добавить контент к существующим страницам с дополнительными временными метками и разделителями.
• Обновление заголовков страниц. Найти и заменить текст на страницах (дело чувствительное или нечувствительное). Добавьте отформатированные заметки (например, вызовы или тодо) на страницы.

OneNote MCP Server

The OneNote MCP Server is a powerful Model Context Protocol (MCP) server that enables AI language models (LLMs) like Claude, and other AI assistants, to securely interact with your Microsoft OneNote data. It allows for reading, writing, searching, and comprehensive editing of your OneNote notebooks, sections, and pages directly through your AI interface.

This server provides a rich set of tools for advanced OneNote management, including robust text extraction, HTML content processing, and fine-grained page manipulation.

Features

• Authentication: Secure device code flow for Microsoft Graph API access.
• Read Operations:
  • List notebooks, sections, and pages.
  • Search pages by title.
  • Get page content in various formats (full HTML, readable text, summary).
• Write & Edit Operations:
  • Create new OneNote pages with custom HTML or markdown content.
  • Update entire page content, preserving or replacing the title.
  • Append content to existing pages with optional timestamps and separators.
  • Update page titles.
  • Find and replace text within pages (case-sensitive or insensitive).
  • Add formatted notes (like callouts or todos) to pages.
  • Insert structured tables into pages from CSV data.
• Advanced Content Processing:
  • Sophisticated HTML to readable text extraction.
  • Markdown-to-HTML conversion for page content.
• Robust Input Validation: Uses Zod for defining and validating tool input schemas.

Prerequisites

• Node.js: Version 18.x or later is recommended. (Install from nodejs.org)
• npm: Usually comes bundled with Node.js.
• Git: For cloning the repository. (Install from git-scm.com)
• Microsoft Account: An active Microsoft account with access to OneNote.
• Azure Application Registration (Recommended for Production/Shared Use):
  • While the server defaults to using the Microsoft Graph Explorer’s public Client ID for easy testing, for regular or shared use, it is strongly recommended to create your own Azure App Registration.
  • Ensure your app registration has the following delegated Microsoft Graph API permissions: Notes.Read, Notes.ReadWrite, Notes.Create, User.Read.
  • You will need the “Application (client) ID” from your app registration.

Installation

1. Clone the Repository:

   git clone https://github.com/[your-github-username]/onenote-ultimate-mcp-server.git
   cd onenote-ultimate-mcp-server
   

   (Replace [your-github-username]/onenote-ultimate-mcp-server with your actual repository URL)

2. Install Dependencies:

   npm install
   

Configuration

1. Azure Client ID: