Outlook (Microsoft 365 Mail and Calendar) su MCP — Pilota Outlook da qualsiasi agente AI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Outlook (Microsoft 365 Mail and Calendar), inserisci le credenziali, genera una MCP API key — fatto. Niente Docker, niente git clone, niente server locale.

Outlook (Microsoft 365 Mail and Calendar)

Fai lavorare la tua AI in Outlook: cerca e leggi le email, archivia i messaggi nelle cartelle, scrivi bozze, invia e rispondi, controlla il calendario, crea e sposta riunioni e trova orari liberi con i colleghi. Microsoft 365 e Outlook.com tramite Microsoft Graph, con il tuo account Microsoft.

Setup

1. Apri l'interfaccia di amministrazione di Microsoft Entra (entra.microsoft.com) o il portale di Azure e vai su Applications → App registrations → New registration.

2. Dai un nome all'app (per esempio "AnythingMCP Outlook") e scegli i Supported account types. La scelta determina cosa va in MICROSOFT_TENANT_ID:

   • Accounts in this organizational directory only (single tenant): possono accedere solo gli utenti della tua organizzazione. Usa la Directory (tenant) ID dalla pagina Overview dell'app (un GUID) o il tuo dominio, per esempio contoso.onmicrosoft.com.
   • Accounts in any organizational directory (multi-tenant): usa organizations.
   • Accounts in any organizational directory and personal Microsoft accounts: usa common (account aziendali, scolastici e Outlook.com) oppure consumers (solo Outlook.com).

   Se il valore non corrisponde al tipo di account, Microsoft rifiuta l'accesso (AADSTS50194 o AADSTS50020).

3. In Redirect URI scegli la piattaforma Web e inserisci https://cloud.anythingmcp.com/api/mcp-oauth/callback. Se ospiti AnythingMCP in proprio, inserisci invece https://tuo-host-anythingmcp/api/mcp-oauth/callback. L'URI deve corrispondere carattere per carattere, altrimenti Microsoft risponde AADSTS50011.

4. Apri API permissions → Add a permission → Microsoft Graph → Delegated permissions e aggiungi offline_access, User.Read, Mail.ReadWrite, Mail.Send e Calendars.ReadWrite. Non aggiungerle come Application permissions: i permessi applicativi darebbero all'app accesso a ogni casella di posta del tenant senza che nessuno effettui l'accesso. Il connettore non ne ha bisogno, lavora come l'utente che accede. offline_access fa sì che Microsoft rilasci un refresh token; senza, il connettore smette di funzionare un'ora dopo l'autorizzazione.

5. Apri Certificates & secrets → New client secret. Copia il Value del secret, non il Secret ID; viene mostrato una sola volta. Annota la data di scadenza: quando il secret scade, il connettore smette di funzionare finché non ne crei uno nuovo e lo inserisci.

6. Inserisci l'Application (client) ID dalla pagina Overview in MICROSOFT_CLIENT_ID, il valore del secret in MICROSOFT_CLIENT_SECRET e il valore del tenant del passo 2 in MICROSOFT_TENANT_ID, poi installa il connettore.

7. Nella pagina del connettore clicca su Authorize with Provider e accedi con la casella di posta su cui deve lavorare l'AI. Il refresh token è salvato cifrato e gli access token (validi circa un'ora) vengono rinnovati automaticamente.

8. Comincia con outlook_get_me: mostra a quale casella di posta è collegato il connettore.

Consenso dell'amministratore: questi permessi delegati di solito non richiedono un amministratore, ma molte organizzazioni disattivano il consenso degli utenti. Se l'accesso mostra "Need admin approval" (AADSTS65001 o AADSTS90094), un amministratore del tenant (per esempio un Global Administrator o un Cloud Application Administrator) apre una volta la registrazione dell'app e clicca su API permissions → Grant admin consent per l'organizzazione. Da quel momento ogni utente può autorizzare. Un connettore autorizzato da un amministratore legge comunque solo la casella di posta dell'amministratore: ogni connettore lavora per l'account che ha effettuato l'accesso.

Solo lettura: sostituisci gli scope nelle impostazioni OAuth del connettore con offline_access User.Read Mail.Read Calendars.Read, autorizza di nuovo e disattiva i tool che inviano o scrivono.

Errori comuni: 401 InvalidAuthenticationToken significa che l'autorizzazione è stata revocata o che il client secret è scaduto; se serve inserisci un nuovo secret e clicca di nuovo su Authorize with Provider. 403 ErrorAccessDenied significa che manca un permesso del passo 4 o che non è stato dato il consenso. MailboxNotEnabledForRESTAPI significa che l'account non ha una casella Exchange Online (per esempio una casella on-premises o un utente senza licenza). outlook_get_free_busy non funziona con gli account personali Outlook.com.

Il connettore non elimina email o eventi e non gestisce allegati, contatti, regole della casella di posta, caselle di altri utenti o caselle condivise.

Prerequisiti: MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

Installazione locale del connettore

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Apri http://localhost:3000/connectors/store, scegli Outlook (Microsoft 365 Mail and Calendar) e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT