mirror of
https://github.com/hanzoskill/mcp-microsoft365.git
synced 2026-10-30 21:10:20 +00:00
2.6 KiB
2.6 KiB
MCP Microsoft 365 Server
An MCP (Model Context Protocol) server for Microsoft 365 integration.
Features
📧 Mail (Outlook)
m365_mail_list- List emails from inbox/foldersm365_mail_read- Read specific emailm365_mail_send- Send emailsm365_mail_search- Search emails
📅 Calendar
m365_calendar_list- List eventsm365_calendar_create- Create events (with Teams meeting support)m365_calendar_availability- Check free/busy status
📁 OneDrive
m365_files_list- List files/foldersm365_files_search- Search filesm365_files_read- Read file contentm365_files_info- Get file metadata
✅ Tasks (To-Do)
m365_tasks_lists- List task listsm365_tasks_list- List tasks in a listm365_tasks_create- Create new task
💬 Teams
m365_teams_chats- List chatsm365_teams_messages- Read chat messagesm365_teams_send- Send message to chat
👥 Users
m365_users_list- List organization usersm365_user_info- Get user profile
Setup
1. Azure Entra ID App
Create an app in Azure Portal:
- Microsoft Entra ID → App registrations → New registration
- Add Application permissions for Microsoft Graph:
Mail.Read,Mail.Send,Mail.ReadWriteCalendars.Read,Calendars.ReadWriteFiles.Read.All,Files.ReadWrite.AllTasks.Read.All,Tasks.ReadWrite.AllChat.Read.All,Chat.ReadWrite.AllUser.Read.All
- Grant admin consent
2. Configure
Create .env file:
TENANT_ID=your-tenant-id
CLIENT_ID=your-client-id
CLIENT_SECRET=your-client-secret
DEFAULT_USER=[email protected]
3. Install & Build
npm install
npm run build
4. Run
npm start
# or
node dist/index.js
5. Use with mcporter
mcporter config add m365 --stdio "node /path/to/dist/index.js"
mcporter call m365.m365_mail_list top:5
Usage Examples
# List emails
mcporter call m365.m365_mail_list top:5
# Send email
mcporter call m365.m365_mail_send to:[email protected] subject:"Hello" body:"<p>Hi there!</p>"
# List calendar events
mcporter call m365.m365_calendar_list top:10
# Create event with Teams meeting
mcporter call m365.m365_calendar_create subject:"Meeting" start:"2024-01-30T10:00:00" end:"2024-01-30T11:00:00" isOnline:true
# List OneDrive files
mcporter call m365.m365_files_list path:"Documents"
# Create task
mcporter call m365.m365_tasks_create listId:"xxx" title:"New task" importance:"high"
Author
Mahmoud Alkhatib - malkhatib.com
License
MIT