One MCP server. Multiple users. Real Microsoft 365 traffic on your test tenant.
The Problem
Test tenants sit empty. Static test data does not exercise real workflows. When you need agents that send real emails, schedule real meetings, and collaborate in real Teams channels, mocks and stubs fall short.
an local MCP server you can run on your env, connecting you to Microsoft Graph, and the complete M365 eco system.
—
What This Solves
This project connects any MCP-compatible AI client to Microsoft 365 through the Graph API. Each agent authenticates as a distinct tenant user and performs real operations against real data.
117 tools across 12 modules: Mail, Calendar, Files, Excel, Word, PowerPoint, Teams, Contacts, To-Do, Groups, People, Search
Multi-user: one server supports your entire team, each with isolated data
Real Graph API calls: every operation hits the actual tenant, not a mock
Secure: tokens encrypted at rest, no credentials stored on third-party servers
Without admin consent, you get Mail, Calendar, Files, Excel workbooks, Word documents, PowerPoint presentations, Contacts, To-Do, Chat, and basic Teams channel operations. With admin consent, you add People directory search, Groups, channel member management, and meeting transcripts.
Open http://localhost:3000 in your browser. Click Login with Microsoft, sign in, and grant permissions. Then click Generate MCP Token and copy the token.
Claude Desktop has a practical limit of ~55 tools per MCP server. This project exposes 117 tools, so we split them across three servers that share the same adapter and backend:
MCP_MODULES filters which modules the adapter exposes. Omit it to expose all 117 tools (works with clients that have no tool cap).
Set MCP_DEBUG=1 in the env block to enable diagnostic logging to stderr — useful for troubleshooting tool dispatch issues.
Restart Claude Desktop. Ask: "What's on my calendar today?" or "Create an Excel workbook with a budget table."
Tools (117)
Mail (9)
Tool
Description
readMail
Read inbox messages
sendMail
Send an email
replyToMail
Reply to an email
readMailDetails
Get full email content
markEmailRead
Mark email as read/unread
flagMail
Flag or unflag an email
getMailAttachments
List email attachments
addMailAttachment
Add attachment to email
removeMailAttachment
Remove attachment from email
Calendar (13)
Tool
Description
getEvents
Get calendar events
createEvent
Create a meeting or event
updateEvent
Modify an existing event
cancelEvent
Cancel an event
acceptEvent
Accept a meeting invitation
tentativelyAcceptEvent
Tentatively accept
declineEvent
Decline a meeting invitation
getAvailability
Check free/busy times
findMeetingTimes
Find optimal meeting slots
getRooms
Find meeting rooms
getCalendars
List all calendars
addAttachment
Add attachment to event
removeAttachment
Remove event attachment
Files (10)
Tool
Description
listFiles
List OneDrive files
uploadFile
Upload a file
downloadFile
Download a file
getFileMetadata
Get file info
getFileContent
Read file contents
setFileContent
Write file contents
updateFileContent
Update existing file
createSharingLink
Create a sharing link
getSharingLinks
List sharing links
removeSharingPermission
Remove sharing access
Excel (30)
Work directly with Excel workbooks stored in OneDrive or SharePoint — no file download needed. All operations go through Microsoft Graph's workbook API with transparent session management.
Tool
Description
createWorkbookSession
Open a workbook session (persistent or temporary)
closeWorkbookSession
Close an active workbook session
listWorksheets
List all worksheets in a workbook
addWorksheet
Add a new worksheet
getWorksheet
Get a worksheet by name or ID
updateWorksheet
Rename, reposition, or hide a worksheet
deleteWorksheet
Delete a worksheet
getRange
Read cell values, formulas, and formatting
updateRange
Write values to a cell range
getRangeFormat
Get formatting (font, fill, borders)
updateRangeFormat
Set formatting (bold, colors, number formats)
sortRange
Sort cells in a range
mergeRange
Merge cells
unmergeRange
Unmerge cells
listTables
List all tables in a worksheet
createTable
Create a table from a range
updateTable
Rename or restyle a table
deleteTable
Delete a table
listTableRows
List all rows in a table
addTableRow
Add a row to a table
deleteTableRow
Delete a row by index
listTableColumns
List all columns in a table
addTableColumn
Add a column to a table
deleteTableColumn
Delete a column
sortTable
Sort a table by column
filterTable
Apply a filter to a table column
clearTableFilter
Clear a column filter
convertTableToRange
Convert a table back to a plain range
callWorkbookFunction
Call any of 300+ Excel functions (SUM, VLOOKUP, PMT, etc.)
calculateWorkbook
Recalculate all formulas
Word (5)
Create, read, and convert Word documents. Documents are created from structured JSON and stored in OneDrive. Reading uses a multi-library fallback chain: mammoth (best HTML for .docx) → word-extractor (handles both .doc and .docx) → webUrl fallback. Binary downloads use the Graph beta /contentStream endpoint for reliable binary transfer.
Tool
Description
createWordDocument
Create a .docx from structured content (headings, paragraphs, tables, lists, images)
readWordDocument
Read a document as HTML and plain text
getWordDocumentMetadata
Get title, author, dates, keywords
getWordDocumentAsHtml
Convert document content to HTML
convertDocumentToPdf
Convert a Word document to PDF
Note: Some SharePoint tenants convert uploaded .docx files to OLE2 binary format within seconds of upload. When this happens, client-side parsing libraries cannot read the file. The server gracefully falls back to returning the webUrl so the user can open the document in the browser.
PowerPoint (4)
Create, read, and convert PowerPoint presentations. Presentations are built from structured slide data and stored in OneDrive. Reading uses Graph HTML conversion with jszip fallback for slide-level text extraction.
Tool
Description
createPresentation
Create a .pptx with title, content, and blank slides
readPresentation
Read slide content (text elements per slide)
getPresentationMetadata
Get title, author, slide count, dates
convertPresentationToPdf
Convert a presentation to PDF
Teams (21)
Tool
Description
listChats
List Teams chats
createChat
Create a new chat
getChatMessages
Read chat messages
sendChatMessage
Send a chat message
listJoinedTeams
List your teams
listTeamChannels
List team channels
createTeamChannel
Create a channel
addChannelMember
Add member to channel
getChannelMessages
Read channel messages
sendChannelMessage
Post to a channel
replyToMessage
Reply to a channel message
listChannelFiles
List files in a channel
uploadFileToChannel
Upload file to channel
readChannelFile
Read a channel file
createOnlineMeeting
Create a Teams meeting
getOnlineMeeting
Get meeting details
listOnlineMeetings
List online meetings
getMeetingByJoinUrl
Find meeting by join URL
getMeetingTranscripts
Get meeting transcripts
getMeetingTranscriptContent
Read transcript content
(Note: addChannelMember applies to private channels only. Standard channels auto-include all team members.)
Contacts (6)
Tool
Description
listContacts
List contacts
getContact
Get contact details
createContact
Create a contact
updateContact
Update contact info
deleteContact
Delete a contact
searchContacts
Search contacts
To-Do (11)
Tool
Description
listTaskLists
List task lists
getTaskList
Get a task list
createTaskList
Create a task list
updateTaskList
Rename a task list
deleteTaskList
Delete a task list
listTasks
List tasks
getTask
Get task details
createTask
Create a task
updateTask
Update a task
deleteTask
Delete a task
completeTask
Mark task complete
Groups (4)
Tool
Description
listGroups
List Microsoft 365 groups
getGroup
Get group details
listGroupMembers
List group members
listMyGroups
List your groups
People (3)
Tool
Description
findPeople
Search the directory
getRelevantPeople
Get frequent contacts
getPersonById
Get person details
Search (1)
Tool
Description
search
Unified search across emails, files, events, and chat messages
Multi-User
Each user authenticates independently. The server isolates all data by user identity.
Alice ([email protected]) Bob ([email protected])
├─ Her own Microsoft tokens ├─ His own Microsoft tokens
├─ Her own session ├─ His own session
└─ Claude Desktop (her laptop) └─ Claude Desktop (his PC)
Complete data isolation.
Alice never sees Bob's data.
For automated testing with multiple agents, use the ROPC (Resource Owner Password Credentials) flow to authenticate programmatically:
# Start the server
npm run dev:web
# Run the E2E test suite (authenticates 3 users via ROPC)
node tests/run-all.cjs
The test suite authenticates multiple users, then exercises all 117 tools across 12 modules plus 5 cross-module workflows. See tests/ for the full implementation.
E2E Test Suite
The project includes a comprehensive test suite covering all 117 tools.
# Run all tests (requires server running)
node tests/run-all.cjs
# Run a single module
node tests/run-all.cjs --bucket mail --buckets-only
# Run only workflows
node tests/run-all.cjs --workflows-only
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas
¿Cómo instalo MCP Microsoft Office?
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿MCP Microsoft Office necesita una clave de API?
Este registro no indica ninguna variable de entorno obligatoria.
¿Qué transporte usa MCP Microsoft Office?
MCP Microsoft Office se ejecuta localmente por stdio.
¿Cuándo se comprobó MCP Microsoft Office por última vez?
Última comprobación: 2026-10-26. an local MCP server you can run on your env, connecting you to Microsoft Graph, and the complete M365 eco system.