MCP Outlook Server

Un serveur Model Context Protocol (MCP) pour Microsoft Outlook, permettant à des agents IA comme Claude Desktop d'interagir avec ta boîte mail et ton calendrier via l'API Microsoft Graph.

✨ Fonctionnalités

• 📧 Mail : Lire, consulter et envoyer des emails

• 📅 Calendrier : Lister et créer des événements avec lien Teams automatique

• 🔐 Authentification : Azure AD Device Code Flow avec cache de token persistant

• 🔄 Auto-refresh : Le token se renouvelle automatiquement

🛠️ Outils disponibles

🧰 Prérequis

• Node.js 18+

• Un compte Microsoft (personnel ou professionnel)

🚀 Installation étape par étape

Étape 1 — Cloner le projet

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

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

1. Aller sur Azure Portal - App Registrations

2. Cliquer "New registration"

3. Remplir le formulaire :

   • Name : MCP Outlook

   • 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

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 :

7. Cliquer "Add permissions"

8. Cliquer "Grant admin consent for ..." puis confirmer

Résultat attendu dans Azure Portal :

✅ User.Read                    (Delegated) - Granted
✅ Mail.Read                    (Delegated) - Granted
✅ Mail.Read.Shared             (Delegated) - Granted
✅ Mail.ReadBasic               (Delegated) - Granted
✅ Mail.ReadWrite               (Delegated) - Granted
✅ Mail.ReadWrite.Shared        (Delegated) - Granted
✅ Mail.Send                    (Delegated) - Granted
✅ Mail.Send.Shared             (Delegated) - Granted
✅ Calendars.Read               (Delegated) - Granted
✅ Calendars.Read.Shared        (Delegated) - Granted
✅ Calendars.ReadBasic          (Delegated) - Granted
✅ Calendars.ReadWrite          (Delegated) - Granted
✅ Calendars.ReadWrite.Shared   (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

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

ℹ️ Utilise common pour un compte personnel, ou ton Tenant ID pour un compte organisation.

Étape 5 — Première authentification Microsoft

node server.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": {
    "outlook": {
      "command": "node",
      "args": [
        "C:\\chemin\\absolu\\vers\\mcp_outlook_01\\server.js"
      ]
    }
  }
}

Étape 7 — Redémarrer Claude Desktop

Fermer et relancer Claude Desktop. Tu peux maintenant demander à Claude :

• "Montre-moi mes derniers emails"

• "Lis l'email de GitHub"

• "Envoie un email à mon collègue"

• "Qu'est-ce que j'ai de prévu cette semaine ?"

• "Planifie une réunion avec [email] demain à 10h" (crée automatiquement un lien Teams)

📁 Structure du projet

mcp_outlook_01/
├── server.js              # Serveur MCP principal
├── .env                   # Variables d'environnement (non commité)
├── .env.example           # Template des variables d'environnement
├── .gitignore             # Fichiers ignorés par Git
├── token_cache.json       # Cache du token MSAL (non commité)
└── package.json           # Dépendances Node.js

📦 Dépendances principales

🔒 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-outlook.log

Erreur d'authentification ou nouvelles permissions ? → Supprimer token_cache.json et relancer node server.js pour se réauthentifier

Erreur fetch is not a function ? → Vérifier que node-fetch est bien installé : npm install node-fetch

Erreur lors de l'envoi d'email ? → Le code gère les réponses 202 Accepted — vérifier que server.js est à jour

📝 Licence

MIT