# 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+](https://nodejs.org)
- Un compte Microsoft (personnel ou professionnel)
- Une clé API Anthropic ([console.anthropic.com](https://console.anthropic.com))

---

## 🚀 Installation étape par étape

### Étape 1 — Cloner le projet

```bash
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](https://portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps)
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](https://portal.azure.com), 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

```bash
cp .env.example .env
```

Éditer `.env` :

```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 :

```bash
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](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`

```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