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

---

🧰 Prérequis

Node.js 18+
Un compte Microsoft (personnel ou professionnel)
Une clé API Anthropic (console.anthropic.com)

---

🚀 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.

Aller sur Azure Portal - App Registrations
Cliquer "New registration"
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

Activer les flux publics :

Menu gauche → Authentication
Scroll bas → Advanced settings
Allow public client flows → Yes
Cliquer Save

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.

Dans le Azure Portal, aller sur ton App Registration
Menu gauche → API permissions
Cliquer "Add a permission"
Choisir Microsoft Graph
Choisir Delegated permissions
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 |

Cliquer "Add permissions"
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 ``

Ouvrir https://microsoft.com/devicelogin
Entrer le code affiché dans le terminal
Se connecter avec ton compte Microsoft
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 :

Parse le HTML de la page
Détecte les balises <img> pointant vers l'API Graph
Fetche chaque image avec le token Bearer Microsoft
Envoie l'image à Claude Vision pour extraire le contenu textuel
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

MCP OneNote Server