Microsoft 365 MCP Server

Full Microsoft 365 integration via Model Context Protocol (MCP).

Features

📧 Mail (Outlook)

• List, read, send, and search emails
• Filter by folder (inbox, sent, drafts)
• HTML email support

📅 Calendar

• List and create events
• Teams meeting integration
• Check availability/free-busy

📁 OneDrive

• Browse files and folders
• Search files
• Read file content

✅ Tasks (Microsoft To-Do)

• List task lists
• Create and manage tasks
• Set importance and due dates

💬 Teams

• List chats
• Read and send messages

👥 Users

• List organization users
• Get user profiles

Requirements

• Node.js 18+
• Azure Entra ID App with Microsoft Graph permissions

Setup

1. Create Azure Entra ID App

Go to [Azure Portal]()

Navigate to Microsoft Entra ID → App registrations → New registration

Configure:

- Name: MCP-Microsoft365
- Supported account types: Single tenant (recommended)
- Redirect URI: ### 2. Add API Permissions Add these **Application permissions** for Microsoft Graph: __CODE_BLOCK_0__ **Important:** Click "Grant admin consent" ### 3. Get Credentials Save these values: - Application (client) ID - Directory (tenant) ID - Client Secret (create under Certificates & secrets) ### 4. Install __CODE_BLOCK_1__ ### 5. Configure mcporter __CODE_BLOCK_2__ Edit config/mcporter.json to add environment variables: __CODE_BLOCK_3__ ## Usage ### Email __CODE_BLOCK_4__ ### Calendar __CODE_BLOCK_5__ ### Files __CODE_BLOCK_6__ ### Tasks __CODE_BLOCK_7__ ### Teams __CODE_BLOCK_8__ ## 19 Available Tools | Tool | Description | |------|-------------| | m365_mail_list | List emails | | m365_mail_read | Read email by ID | | m365_mail_send | Send email | | m365_mail_search | Search emails | | m365_calendar_list | List events | | m365_calendar_create | Create event | | m365_calendar_availability | Check free/busy | | m365_files_list | List files | | m365_files_search | Search files | | m365_files_read | Read file content | | m365_files_info | Get file metadata | | m365_tasks_lists | List task lists | | m365_tasks_list | List tasks | | m365_tasks_create | Create task | | m365_teams_chats | List chats | | m365_teams_messages | Read messages | | m365_teams_send | Send message | | m365_users_list | List users | | m365_user_info` | Get user profile |

Author

Mahmoud Alkhatib

• Website: [malkhatib.com]()


• YouTube: [@malkhatib]()


• Twitter: [@malkhateeb]()

MIT