OneNote Graph API

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.

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

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