Skip to main content
Glama
MCP OneNote Server

MCP OneNote Server

by FRESHSK

MCP OneNote Server

Un serveur Model Context Protocol (MCP) pour Microsoft OneNote, permettant à des agents IA comme Claude Desktop de lire, créer et analyser des notebooks, sections et pages OneNote — y compris l'extraction automatique du contenu des images via Claude Vision.


✨ Fonctionnalités

  • 📒 Lister les notebooks, sections et pages

  • 📄 Lire le contenu HTML des pages

  • 🖼️ Extraire le texte des images embarquées via Claude Vision (nouveau !)

  • ✏️ Créer des notebooks, sections et pages

  • 🔐 Authentification via Azure AD Device Code Flow


Related MCP server: onenote-mcp

🧰 Prérequis


🚀 Installation étape par étape

Étape 1 — Cloner le projet

git clone https://github.com/FRESHSK/mcp_onenote.git
cd mcp_onenote_01
npm install

Étape 2 — Créer une App Azure AD (une seule fois)

Cette étape permet d'obtenir un Client ID pour accéder à l'API Microsoft Graph.

  1. Aller sur Azure Portal - App Registrations

  2. Cliquer "New registration"

  3. Remplir le formulaire :

    • Name : MCP OneNote

    • Supported account types : choisir la 3ème option (Multitenant + personal Microsoft accounts)

    • Redirect URI : Public client/native → http://localhost

    • Cliquer Register

  4. Activer les flux publics :

    • Menu gauche → Authentication

    • Scroll bas → Advanced settings

    • Allow public client flows → Yes

    • Cliquer Save

  5. Copier l'Application (client) ID depuis Overview


Étape 3 — Ajouter les permissions Microsoft Graph API

Après avoir créé l'app Azure AD, tu dois accorder les permissions nécessaires pour accéder à OneNote.

  1. Dans le Azure Portal, aller sur ton App Registration

  2. Menu gauche → API permissions

  3. Cliquer "Add a permission"

  4. Choisir Microsoft Graph

  5. Choisir Delegated permissions

  6. Rechercher et cocher les permissions suivantes :

Permission

Description

User.Read

Lire le profil de l'utilisateur connecté

Notes.Read

Lire les notebooks OneNote

Notes.Create

Créer des notebooks et pages

Notes.ReadWrite

Lire et modifier les notebooks OneNote

  1. Cliquer "Add permissions"

  2. Cliquer "Grant admin consent for ..." (si tu es admin) puis confirmer

ℹ️ Si tu n'es pas admin, les permissions seront accordées lors de la première connexion via Device Code Flow.

Résultat attendu dans Azure Portal :

✅ User.Read              (Delegated) - Granted
✅ Notes.Read             (Delegated) - Granted
✅ Notes.Create           (Delegated) - Granted
✅ Notes.ReadWrite        (Delegated) - Granted

Étape 4 — Configurer les variables d'environnement

cp .env.example .env

Éditer .env :

MICROSOFT_CLIENT_ID=ton-client-id-azure
MICROSOFT_TENANT_ID=common
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx
TOKEN_CACHE_PATH=./token_cache.json

⚠️ Ne jamais committer le fichier .env — il est dans .gitignore


Étape 5 — Première authentification Microsoft

Le serveur a besoin d'un token Microsoft pour accéder à OneNote. Lance ce script une fois :

node debug_auth.js

Tu verras dans le terminal :

To sign in, use a web browser to open the page
https://microsoft.com/devicelogin and enter the code XXXXXXXX
  1. Ouvrir https://microsoft.com/devicelogin

  2. Entrer le code affiché dans le terminal

  3. Se connecter avec ton compte Microsoft

  4. Un fichier token_cache.json sera créé automatiquement

✅ Cette étape n'est nécessaire qu'une seule fois. Le token se renouvelle automatiquement.


Étape 6 — Configurer Claude Desktop

Éditer le fichier claude_desktop_config.json de Claude Desktop :

  • Windows : C:\Users\<user>\AppData\Roaming\Claude\claude_desktop_config.json

  • Mac : ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "onenote": {
      "command": "node",
      "args": [
        "C:\\chemin\\absolu\\vers\\mcp_onenote_01\\server.js"
      ],
      "env": {
        "TOKEN_CACHE_PATH": "C:\\chemin\\absolu\\vers\\mcp_onenote_01\\token_cache.json"
      }
    }
  }
}

⚠️ Le TOKEN_CACHE_PATH absolu est important pour que Claude Desktop trouve le bon fichier de token.


Étape 7 — Redémarrer Claude Desktop

Fermer et relancer Claude Desktop. Le MCP OneNote sera disponible.


🛠️ Outils disponibles

Outil

Description

Paramètres

list_notebooks

Liste tous les notebooks

—

list_sections

Liste les sections d'un notebook

notebookId

list_pages

Liste les pages d'une section

sectionId

read_content

Lit le contenu d'une page (texte + images)

pageId, extract_images (bool, défaut: true)

create_notebook

Crée un nouveau notebook

displayName

create_section

Crée une nouvelle section

notebookId, displayName

create_page

Crée une nouvelle page

sectionId, htmlContent


🖼️ Extraction d'images (Claude Vision)

Quand extract_images: true (par défaut), le tool read_content :

  1. Parse le HTML de la page

  2. Détecte les balises <img> pointant vers l'API Graph

  3. Fetche chaque image avec le token Bearer Microsoft

  4. Envoie l'image à Claude Vision pour extraire le contenu textuel

  5. Retourne le texte + le contenu extrait de chaque image

Pour désactiver cette fonctionnalité :

read_content(pageId: "...", extract_images: false)

📁 Structure du projet

mcp_onenote_01/
├── server.js                   # Serveur MCP principal
├── debug_auth.js               # Script d'authentification initiale
├── .env                        # Variables d'environnement (non commité)
├── .env.example                # Template des variables d'environnement
├── .gitignore                  # Fichiers ignorés par Git
├── claude_desktop_config.json  # Exemple de config Claude Desktop
├── token_cache.json            # Cache du token MSAL (non commité)
└── package.json                # Dépendances Node.js

📦 Dépendances principales

Package

Usage

@modelcontextprotocol/sdk

Serveur MCP

@azure/msal-node

Authentification Microsoft

@anthropic-ai/sdk

Claude Vision pour les images

node-fetch

Requêtes HTTP

dotenv

Variables d'environnement


🔒 Sécurité

  • Le fichier .env contenant les clés est dans .gitignore

  • Le token_cache.json contenant les tokens Microsoft est dans .gitignore

  • Ne jamais committer de clés API ou de tokens dans GitHub


🐛 Dépannage

Le MCP ne répond pas dans Claude Desktop ? → Vérifier les logs : AppData\Roaming\Claude\logs\mcp-server-onenote.log

Le token expire et redemande l'authentification ? → S'assurer que TOKEN_CACHE_PATH pointe vers le bon chemin absolu dans claude_desktop_config.json → Relancer node debug_auth.js pour renouveler le token

Erreur media_type sur les images ? → Le code normalise automatiquement vers image/png si le type n'est pas supporté par l'API Anthropic


📝 Licence

MIT

Available Tools

7 tools
create_notebookB

Create a new OneNote notebook

Inputs: displayName (required).

create_pageA

Create a new page in a section

Inputs: sectionId (required), htmlContent (required).

create_sectionA

Create a new section in a notebook

Inputs: notebookId (required), displayName (required).

list_notebooksA

List all OneNote notebooks

Inputs: no named parameters.

list_pagesA

List pages in a section

Inputs: sectionId (required).

list_sectionsB

List sections in a notebook

Inputs: notebookId (required).

read_contentA

Read the HTML content of a page

Inputs: pageId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: notebooks, sections, pages, and page content are clearly separated. The hierarchy is obvious from the names and descriptions, so an agent should rarely confuse one tool with another.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern such as list_notebooks and create_page. read_content is a slight departure since it refers to a page action but does not include 'page' in the name, though it remains clear and readable.

    Tool Count5/5

    Seven tools is well-scoped for a OneNote MCP server focused on navigating and creating notebooks, sections, and pages. Each tool covers a necessary operation without redundancy or bloat.

    Completeness3/5

    The create and read/list side of the domain is covered well, but there are no update or delete operations for notebooks, sections, or pages. This creates notable gaps for editing or cleaning up content, though basic browsing and creation workflows are functional.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      D
      quality
      C
      maintenance
      Enables AI assistants to securely interact with Microsoft OneNote data through the Microsoft Graph API. It supports comprehensive management tasks including searching page content, creating and editing notes, and automating productivity workflows like daily note creation.
      20
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to read, write, and manage Microsoft OneNote notebooks, sections, and pages through OAuth-authenticated MCP tools, resources, and prompts.
      16
      36 npm
      5
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude to sign in with a Microsoft account and read, write, search, create, move, and organize notebooks, section groups, sections, and pages, including drawing Mermaid or SVG diagrams rendered into notes. It also fetches embedded images and page contents as Markdown so handwritten-note workflows and checkboxes can be managed conversationally.
      36 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude to browse, search, and read Microsoft OneNote notebooks and pages as clean markdown, including viewing screenshots and images at high resolution or zoomed into regions. It also lets users collect pages into reports and write, append, or edit pages, sections, and notebooks, and export original-resolution images and attachments locally.
      14
      36 npm
      2
      MIT

    Appeared in Searches