outlook-mcp-gdpr
This is an MCP server for pseudonymized Microsoft 365 access; the provided schema exposes Outlook mail tools, while the README also documents optional calendar, Teams, and SharePoint modules.
List folders and messages, including unread filtering and pagination.
Search the mailbox by free text.
Read full messages, without fetching attachments.
Mark messages read/unread, flag/unflag, set categories, and move messages.
Create, update, and delete mail drafts and reply drafts, but never send email.
Pseudonymize personal data before it reaches Claude and restore tokens in drafts.
Optionally enable calendar read/create/delete of own events, Teams chat/channel reading, and SharePoint release upload/listing.
Optionally use an audit page and a restricted test-mail folder for safe verification.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@outlook-mcp-gdpr list my unread emails and draft a reply to the latest one"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
m365-mcp-gdpr
MCP-server som ger Claude åtkomst till Microsoft 365 – Outlook, kalender, Teams och en SharePoint-mapp för releaser – via Microsoft Graph, med pseudonymisering av personuppgifter innan något lämnar er maskin.
Det är samma data som Microsoft 365 Copilot arbetar mot. Copilot har inget eget API för att läsa/skriva mejl, så servern pratar direkt med Microsoft Graph.
Vad den kan
Servern är uppdelad i delar som slås på var för sig med M365_MCP_FEATURES
(se Välja delar). Som standard är bara sharepoint påslagen.
Del | Verktyg | Beskrivning |
|
| Mappar med antal (olästa) |
|
| Lista mejl i en mapp, filtrera på olästa |
|
| Fritextsök i hela brevlådan |
|
| Läs ett mejl (bilagors innehåll hämtas inte) |
|
| Administrera |
|
| Utkast |
|
| Läs kalendern för en period, eller en händelse med beskrivning |
|
| Boka tid i din egen kalender (t.ex. fokustid) – aldrig med deltagare |
|
| Ta bort egen händelse utan deltagare |
|
| Lista chattar och läs meddelanden |
|
| Lista team och kanaler, läs inlägg |
|
| Ladda upp en lokal fil (t.ex. release-zip) till en förbestämd SharePoint-mapp |
|
| Lista filer i release-mappen, med länkar |
Valfritt: en lokal granskningssida som visar exakt vad Claude får.
Servern skickar aldrig något till andra personer. Allt som når någon annan granskas och skickas av en människa:
Mejl: bara utkast. Servern begär aldrig
Mail.Send, så den saknar behörighet att skicka.delete_draftvägrar radera något som inte är ett utkast.Kalender: bara tid i din egen kalender. Möten med deltagare skapas inte (det skickar inbjudningar), och möten med deltagare raderas inte (det skickar avbokningar).
Teams: bara läsning. Teams har inga utkast, så servern begär ingen skrivbehörighet.
Namn, deltagare, platser och meddelandetext i mejl, kalender och Teams tvättas på samma sätt innan de når Claude.
Related MCP server: outlook_mcp
Hur GDPR-tvätten fungerar
Outlook ──Graph──▶ [ MCP-server: redact() ] ──tokens──▶ Claude
Outlook ◀─Graph─── [ MCP-server: restore() ] ◀─tokens── Claude
│
Vault (endast RAM)När ett mejl hämtas lär sig servern namn och adresser ur avsändare/mottagare.
Ämne, förhandsvisning, brödtext, bilagenamn och adresser tvättas. Ersätts med stabila tokens:
Hej [[PERSON_1_FIRST]]! Mitt personnummer är 18830702-6115, ring [[PHONE_1]]. Adress: [[ADDRESS_1]]. /[[PERSON_2]] [[EMAIL_3]]Kopplingen token → riktigt värde finns bara i serverprocessens minne och skickas aldrig till modellen. Den försvinner när servern stängs.
När Claude skriver ett utkast med tokens byts de tillbaka till riktiga värden innan utkastet sparas i Outlook. Okända tokens avvisas.
Detekteras: e-postadresser, telefonnummer (svenska + internationella), IBAN,
kortnummer (Luhn), IP-adresser, svenska gatuadresser och postnummer+ort, samt
personnamn från mejlhuvuden, e-postadresser (fornamn.efternamn@) och en valfri
namnlista. Med REDACT_USE_NER=1 används även spaCys svenska NER-modell för namn i fritext.
Personnummer från Sverige (även samordningsnummer), Danmark (CPR), Norge
(fødselsnummer, D-nummer) och Finland (henkilötunnus) ersätts inte med en token utan
med ett påhittat nummer i samma format, med födelseår på 1800-talet, t.ex.
18830702-6115. Ingen levande person kan ha det, och där formatet har kontrollsiffra
är den giltig. Svenska nummer med bindestreck fångas även om kontrollsiffran är fel
(felskrivna nummer är fortfarande personuppgifter). Tio siffror utan bindestreck kräver
rätt kontrollsiffra, så att vanliga order- och telefonnummer inte tvättas i onödan.
Fejknumret byts tillbaka till det riktiga om Claude använder det i ett utkast.
Begränsningar – läs detta
Regelbaserad tvätt är aldrig 100 %. Namn i fritext på personer som inte förekommer i mejlhuvuden fångas bara med NER eller namnlista. Hälsodata, fackmedlemskap och andra känsliga uppgifter (art. 9) i fritext fångas inte.
Pseudonymiserade uppgifter är fortfarande personuppgifter enligt GDPR (art. 4.5, skäl 26). Tvätten är en skyddsåtgärd (dataminimering, art. 25 och 32) – den ersätter inte rättslig grund, personuppgiftsbiträdesavtal (DPA) med Anthropic, registerförteckning eller eventuell DPIA.
Mejl-ID:n och datum skickas otvättade (de är inte personuppgifter i sig).
Installation
1. App-registrering i Microsoft Entra ID
Appregistreringen ger servern en identitet mot Microsoft (ett client-ID). Microsoft kräver det för alla program som loggar in mot Microsoft 365 för användarens räkning. Den behövs en gång per organisation, inte per användare. Om organisationen tillåter det (standard i Entra ID) kan en vanlig användare registrera appen själv; annars gör IT det.
Entra admin center → App registrations → New registration.
Supported account types: Endast den här organisationen.
Authentication → Add a platform → Mobile and desktop applications, lägg till:
http://localhost(inloggning via webbläsare)ms-appx-web://Microsoft.AAD.BrokerPlugin/<client-id>(Windows inbyggda kontoruta)msauth.com.msauth.unsignedapp://auth(Mac med Company Portal)
Authentication → Allow public client flows = Yes (behövs bara för
--device-code).API permissions → Microsoft Graph → Delegated:
User.Readplus behörigheten för varje del ni ska använda (se Välja delar):Sites.ReadWrite.Allförsharepoint,Mail.ReadWriteförmail,Calendars.ReadWriteförcalendarochChat.Read,Team.ReadBasic.All,Channel.ReadBasic.All,ChannelMessage.Read.Allförteams. Av dessa kräver baraChannelMessage.Read.Allgodkännande av en admin; övriga kan användaren godkänna själv vid inloggningen, om organisationen tillåter det. Behörigheterna är delegerade: servern kommer bara åt det du själv har behörighet till.Notera Application (client) ID och Directory (tenant) ID.
2. Installera programmet
Kräver Python 3.11 eller senare. Installera med pipx, så hamnar
programmet i en egen miljö och kommandot m365-mcp-gdpr blir tillgängligt överallt:
pipx install git+https://github.com/Lonestarrk/m365-mcp-gdprMac med Company Portal (för inloggningsrutan i stället för webbläsaren):
pipx install "m365-mcp-gdpr[broker] @ git+https://github.com/Lonestarrk/m365-mcp-gdpr"Är repot privat behöver du vara inloggad mot GitHub på datorn först, t.ex. med gh auth login.
3. Installera i Claude Code
claude mcp add m365 --scope user \
-e M365_MCP_CLIENT_ID=<client-id> \
-e M365_MCP_TENANT_ID=<tenant-id> \
-e M365_MCP_LOGIN_HINT=<din jobbmejl> \
-e M365_MCP_FEATURES=sharepoint \
-e SHAREPOINT_SITE="matildafoodtech.sharepoint.com:/sites/<webbplats>" \
-e SHAREPOINT_FOLDER="<mapp för releaser>" \
-e SHAREPOINT_UPLOAD_ROOTS="<sökväg till projektets dist-mapp>" \
-- m365-mcp-gdpr--scope usergör servern tillgänglig i alla dina projekt. Utan den gäller den bara i mappen du står i.På Windows (PowerShell/cmd): skriv allt på en rad utan
\.SharePoint-raderna kan utelämnas om du bara ska använda mejl, och tvärtom. Alla inställningar finns under Konfiguration.
Starta Claude Code och kör /mcp. m365 ska stå som ansluten. Första gången Claude
använder servern öppnas inloggningen (se nedan).
Ändra inställningar: ta bort och lägg till igen:
claude mcp remove m365 --scope user
claude mcp add m365 --scope user ...Uppdatera till senaste versionen: pipx upgrade m365-mcp-gdpr och starta om Claude Code.
Avinstallera: claude mcp remove m365 --scope user, m365-mcp-gdpr logout och
pipx uninstall m365-mcp-gdpr.
4. Logga in
Inloggningen sker med ditt vanliga jobbkonto:
Windows: systemets egen kontoruta visas, med ditt jobbkonto förvalt. Ofta behövs inget lösenord alls om du redan är inloggad i Windows med jobbkontot.
Mac: via Company Portal om den är installerad (se steg 2), annars öppnas Microsofts inloggningssida i webbläsaren.
Linux: Microsofts inloggningssida öppnas i webbläsaren.
Tvåfaktorsinloggning (t.ex. Microsoft Authenticator) sköts som vanligt i den rutan.
Du behöver bara logga in en gång. Inloggningen sparas krypterat i operativsystemets nyckelring (Windows DPAPI, macOS Keychain, Linux libsecret) och förnyas tyst i bakgrunden. Den håller så länge du använder den regelbundet – som standard upphör den efter 90 dagar utan användning. Er IT kan ha regler (Conditional Access, "sign-in frequency") som kräver ny inloggning oftare; det styrs av organisationen, inte av servern.
Inloggningen öppnas automatiskt första gången Claude använder servern. På Windows rekommenderas att logga in i förväg i ett terminalfönster: när Claude Code startar servern i bakgrunden kan kontorutan hamna bakom andra fönster. Efter första inloggningen sker allt tyst. Kör i en terminal (macOS/Linux):
M365_MCP_CLIENT_ID=<client-id> M365_MCP_TENANT_ID=<tenant-id> m365-mcp-gdpr loginPowerShell:
$env:M365_MCP_CLIENT_ID="<client-id>"; $env:M365_MCP_TENANT_ID="<tenant-id>"; m365-mcp-gdpr loginm365-mcp-gdpr logout tar bort den sparade inloggningen. På en dator utan webbläsare:
m365-mcp-gdpr login --device-code.
Claude Desktop
Lägg till i claude_desktop_config.json och starta om Claude Desktop:
{
"mcpServers": {
"m365": {
"command": "m365-mcp-gdpr",
"env": {
"M365_MCP_CLIENT_ID": "<client-id>",
"M365_MCP_TENANT_ID": "<tenant-id>"
}
}
}
}Välja delar av Microsoft 365
M365_MCP_FEATURES är en kommaseparerad lista över de delar servern ska ge Claude
tillgång till:
Värde | Ger |
| Uppladdning och listning av releaser i en SharePoint-mapp |
| Läsa, organisera och skriva utkast i Outlook, med GDPR-tvätt |
| Läsa kalendern och boka tid för dig själv, med GDPR-tvätt |
| Läsa chattar och kanaler, med GDPR-tvätt |
t.ex. | Flera delar, kommaseparerat |
| Allt ovan |
Behörigheter per del:
Del | Microsoft Graph-behörighet (delegerad) |
|
|
|
|
|
|
|
|
alltid |
|
En del som inte är påslagen är avstängd på två nivåer:
Verktygen finns inte. Claude ser dem inte och kan inte anropa dem.
Behörigheten begärs inte. Inloggningen ber bara Microsoft om behörigheterna för de påslagna delarna. Med bara
sharepointinnehåller inloggningen ingen rätt till mejlen alls, så Microsoft skulle vägra även om något gick fel i servern.
Slår du på en ny del senare får du logga in en gång till, för att godkänna den nya behörigheten. Ett felstavat namn stoppar servern med ett tydligt felmeddelande.
Copilot som extra tvättsteg (valfritt)
Reglerna ovan hittar nummer, adresser och kända namn, men inte namn i löptext, uppgifter
som pekar ut någon indirekt ("kökschefen på Solgårdens förskola") eller känsliga
uppgifter som allergier. Med M365_MCP_REDACT_ENGINE=copilot granskar Microsoft 365
Copilot varje mejl innan Claude får det:
Lokala regler tvättar nummer, adresser och kända namn, som vanligt.
Copilot pekar ut namn i löptext och indirekta identifierare, som sedan tvättas, och avgör om mejlet innehåller känsliga uppgifter (GDPR art. 9: hälsa, allergier, specialkost, religion m.m.). Då blockeras hela mejlet och Claude ser bara att det är blockerat och varför.
Säker hållning: om Copilot inte svarar eller svarar i fel format blockeras mejlet. Inget släpps igenom ogranskat.
En lista med mejl granskas i ett enda anrop till Copilot. Webbsökning är avstängd i anropet, och Copilots svar används bara lokalt; det skickas aldrig till Claude.
Instruktionerna till Copilot ligger i
copilot_instructions.md. Vill ni ändra
dem, kopiera filen, redigera och peka ut den med M365_MCP_COPILOT_INSTRUCTIONS.
Krav:
En Microsoft 365 Copilot-licens för användaren (gratisversionen Copilot Chat räcker inte).
Copilot Chat API (Microsoft Graph beta) kräver sju delegerade behörigheter samtidigt:
Sites.Read.All,Mail.Read,People.Read.All,OnlineMeetingTranscript.Read.All,Chat.Read,ChannelMessage.Read.All(kräver admin) ochExternalItem.Read.All. De läggs till i app-registreringen och begärs bara när Copilot-steget är påslaget.Inställningen "Enable Anthropic as a Microsoft subprocessor" i Microsoft 365 admin center bör vara avstängd. Annars kan Copilot själv använda Claude-modeller, och mejlet kan behandlas av Anthropic redan i tvättsteget.
Copilot-steget gäller i dag mejl (lista, sök och läs). Kalender och Teams tvättas med de lokala reglerna.
Testa säkert med en testmapp
Med M365_MCP_MAIL_FOLDER=<mappnamn> kommer mejlverktygen bara åt en enda mapp. Lista,
sök och läs fungerar bara där, åtgärder på mejl utanför mappen vägras och flytt är
avstängd. Utkast fungerar som vanligt. Mappen kan ligga överst eller direkt under Inkorgen.
Så här testar du tvätten utan riktiga kunduppgifter:
Skapa mappen
MCP-testi Outlook.Skicka några mejl till dig själv med påhittade namn, personnummer, telefonnummer, adresser och t.ex. allergier, och flytta dem till mappen.
Installera med
M365_MCP_FEATURES=mail,M365_MCP_MAIL_FOLDER=MCP-testochM365_MCP_AUDIT=1.Be Claude läsa och svara på testmejlen, och jämför på granskningssidan.
Granskningssida (valfri)
Vill du se exakt vad Claude får, kan servern visa en lokal webbsida med varje anrop sida vid sida: till vänster det tvättade som skickades till Claude (tokens i blått), till höger originalet med de tvättade delarna markerade (gult). För utkast syns även vad som skickas vidare till Microsoft efter att tokens bytts tillbaka.

Slå på den genom att lägga till -e M365_MCP_AUDIT=1 i claude mcp add. När Claude Code
startar servern öppnas sidan automatiskt i webbläsaren.
Eftersom sidan visar riktiga personuppgifter är den skyddad:
Avstängd som standard. Ingenting registreras när den är av.
Bara din dator. Den lyssnar bara på
127.0.0.1och avvisar andra adresser.Hemlig länk. Adressen innehåller en slumpad nyckel som byts vid varje start. Länken skickas aldrig till Claude.
Inget på disk. De senaste 200 anropen finns bara i minnet och försvinner när servern stängs. Knappen Rensa tömmer dem direkt.
Sidan visar det som går via den här servern. Vill du se all trafik från Claude Code
till Anthropic (det du skriver, filer Claude läser osv.) kan du köra Claude Code genom
en lokal proxy som mitmproxy: sätt HTTPS_PROXY=http://127.0.0.1:8080
och NODE_EXTRA_CA_CERTS till mitmproxys certifikat innan du startar claude.
SharePoint-releaser
Servern kan lägga releaser som Claude Code byggt i en fast SharePoint-mapp, så att kollegor alltid hittar senaste versionen. Claude kan bara ladda upp till den konfigurerade mappen (och undermappar till den), aldrig någon annanstans.
Mappen ställs in med SHAREPOINT_SITE, SHAREPOINT_FOLDER och SHAREPOINT_UPLOAD_ROOTS
(se Installera i Claude Code).
Exempel i Claude Code: "Bygg en release, zippa dist-mappen och ladda upp den till SharePoint i undermappen v1.4.0." Befintliga filer skrivs inte över om du inte ber om det. Filer över 4 MB laddas upp i delar, så stora releaser fungerar.
Konfiguration
Variabel | Beskrivning |
| Krävs. Client ID från app-registreringen |
| Tenant-ID (standard |
| Var token-cachen sparas |
| Ditt jobbmejl, förifyllt i inloggningsrutan |
|
|
|
|
| Termer som inte ska tvättas (företagsnamn, orter, produkter) |
| Extra namn som alltid ska tvättas (t.ex. kundregister-export), ett per rad |
| Webbplats som |
| Dokumentbibliotekets namn (standard: webbplatsens standardbibliotek) |
| Mappen releaser laddas upp till, t.ex. |
| Valfritt. Kommaseparerade lokala mappar som får laddas upp från – rekommenderas, så att Claude inte kan ladda upp andra filer |
| Vilka delar som är påslagna: |
|
|
| Sökväg till egna instruktioner för Copilot-steget |
| Begränsa mejlverktygen till en enda mapp, t.ex. |
| Tidszon för kalendern, t.ex. |
|
|
| Fast port för granskningssidan (standard: slumpad ledig port) |
|
|
|
|
Utveckling
pip install -e '.[dev]'
pytestAvailable Tools
12 toolscreate_draftB
Skapa ett nytt utkast i Utkast-mappen. Skickas INTE.
Använd tokens (t.ex. [[EMAIL_1]], [[PERSON_2_FIRST]]) ordagrant – de ersätts med riktiga värden.
Inputs: body (required), subject (required), cc, to.
create_reply_draftB
Skapa ett svarsutkast på ett befintligt meddelande. Skickas INTE.
Inputs: body (required), message_id (required), reply_all.
delete_draftA
Radera ett utkast. Fungerar bara på utkast, aldrig på mottagna mejl.
Inputs: draft_id (required). Returns: result
flag_messageC
Flagga eller avflagga ett meddelande för uppföljning.
Inputs: message_id (required), flagged. Returns: result
list_foldersA
Lista mappar i brevlådan med antal (olästa) meddelanden.
Inputs: no named parameters. Returns: result
list_messagesC
Lista meddelanden i en mapp, nyast först.
folder: mapp-id eller välkänt namn (inbox, drafts, sentitems, archive, deleteditems, junkemail).
Inputs: top, skip, folder, unread_only. Returns: result
mark_readC
Markera ett meddelande som läst eller oläst.
Inputs: message_id (required), is_read. Returns: result
move_messageB
Flytta ett meddelande. destination: mapp-id eller välkänt namn (archive, deleteditems, inbox …).
Inputs: message_id (required), destination (required).
read_messageB
Läs ett helt meddelande (pseudonymiserat). Bilagornas innehåll hämtas inte.
Inputs: message_id (required).
search_messagesB
Fritextsök i hela brevlådan. Tokens som [[PERSON_1]] får användas i söksträngen.
Inputs: query (required), top. Returns: result
set_categoriesB
Sätt Outlook-kategorier på ett meddelande (ersätter befintliga).
Inputs: categories (required), message_id (required). Returns: result
update_draftB
Uppdatera ett befintligt utkast. Fält som utelämnas lämnas orörda.
Inputs: draft_id (required), cc, to, body, +1 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool targets a distinct action or resource: folder listing, message listing/searching/reading, status changes, moving, categorizing, and draft lifecycle. Overlaps such as list_messages vs. search_messages are clearly differentiated by scope, and draft creation vs. reply-draft creation is explicit.
All tool names use consistent snake_case with a predictable verb_noun pattern (list_folders, read_message, create_draft, update_draft, delete_draft). Minor variations like mark_read and create_reply_draft remain readable and follow the same convention.
Twelve tools are well-scoped for an Outlook/GDPR email client, covering reading, organizing, and draft management without excessive fragmentation. Each tool appears to earn its place.
The surface covers core mailbox reading, search, organization, flagging, categorization, and draft create/reply/update/delete workflows. Gaps include sending messages, deleting received messages, and attachment content access, though some omissions may be intentional under GDPR constraints.
Related MCP Connectors
Connect any IMAP/SMTP mailbox to Claude & ChatGPT: search, read, sort, draft. Sends only with OK.
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Connect Gmail, iCloud Mail, Outlook, Yahoo Mail, Fastmail and other IMAP inboxes to ChatGPT, Claude and compatible AI assistants. Find emails by meaning across languages with semantic search. Ask AI to find customer conversations, summarize deadlines and draft follow-ups. Give a sales rep access to a shared outreach inbox or bring email into a compatible CRM. Share an iCloud custom-domain inbox with teammates without their own Apple ID or iCloud+ plan. Search results may be incomplete or stale; separate permissions control mail actions.
Your mailboxes in ChatGPT and Claude: Gmail, iCloud, Fastmail, any IMAP. Passwords stay yours.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides Claude Desktop and Claude Code with access to Microsoft 365 email and calendar services via the Microsoft Graph API. It enables users to manage emails, search folders, schedule calendar events, and check availability through natural language commands.-
- AlicenseNot gradedqualityDmaintenanceConnects Claude to Microsoft 365 Outlook and Google Gmail APIs for email search, invoice detection, attachment handling, folder/label management, and draft creation. Uses Anthropic OAuth for secure authentication.31 npmISC
- AlicenseAqualityCmaintenanceGives Claude Code access to Outlook Mail, Calendar, and Contacts via Microsoft Graph, with safety-first defaults (no sending, no hard deletes, every mutation logged). Supports multiple Microsoft accounts through a PKCE OAuth flow.21MIT
- AlicenseNot gradedqualityBmaintenanceEnables Claude and ChatGPT to read, search, and organize mail in a user's own email account, including folders, threads, attachments, drafts, and optional sending, with per-user permission levels and OAuth-secured remote connections.MIT