================== /// MCP /// /// MS- /// ================== [server:online] [protocol:ready]
ms-365-mcp-server
by Softeria
Model Context Protocol (MCP) server that exposes Microsoft 365 / Office functionality over the Graph API with authentication, read-only mode, tool filtering and HTTP or stdio transport.
185
51
SpecializedInstallation
1. Prerequisites
• Node.js ≥18 and npm installed
• A Microsoft Entra (Azure AD) app registration with the following values recorded:
- CLIENT_ID
- CLIENT_SECRET
- TENANT_ID (directory ID)
• The app registration must be granted the Graph API permissions you intend to expose through MCP (e.g. Mail.Read, Calendars.Read, Files.Read, etc.) and consented by an administrator.
2. Clone the repository
git clone https://github.com/Softeria/ms-365-mcp-server.git
cd ms-365-mcp-server
3. Install dependencies
npm install
4. Provide configuration (env or .env file)
MCP_PORT=3000
CLIENT_ID=<your-client-id>
CLIENT_SECRET=<your-client-secret>
TENANT_ID=<your-tenant-id>
SCOPES="Mail.Read Calendars.Read Files.Read User.Read"
5. Build TypeScript -> JavaScript
npm run build
6. Start the MCP server
npm start # or: node dist/index.js
7. Verify
GET http://localhost:3000/health → { "status": "ok" }
8. Container option
docker build -t ms-365-mcp-server .
docker run -p 3000:3000 --env-file .env ms-365-mcp-server
Documentation
License: MIT License
Updated 7/30/2025