eshlon/onenotemcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

14 stars 13 forks 品質 73 トレンド 20MIT

Repository Install

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. * Secure device code flow for Microsoft Graph API access. * * List notebooks, sections, and pages. * Search pages by title. * Get page content in various formats (full HTML, readable text, summary). * * 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.

README

以下は原文 README の抜粋です。原文を見る。

OneNote MCP Server

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

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)

Install Dependencies:
```
npm install
```

Configuration

Azure Client ID:

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
      "mcpServers": {
        "onenote": {
          "command": "node",
          "args": ["/full/path/to/your/onenote-ultimate-mcp-server/onenote-mcp.mjs"],
          "env": {
            // Recommended: Set AZURE_CLIENT_ID here if not set globally
            "AZURE_CLIENT_ID": "YOUR_AZURE_APP_CLIENT_ID_HERE" 
          }
        }
      }
    }