@leonardocrdso/office365-mcp-server

An MCP (Model Context Protocol) server for Microsoft 365 integration. Interact with Outlook, Calendar, OneDrive, SharePoint and Teams via Microsoft Graph API.

Installation

Using npx (recommended)

AZURE_CLIENT_ID=your-client-id npx @leonardocrdso/office365-mcp-server

Adding to Claude Code

claude mcp add office365-mcp-server -e AZURE_CLIENT_ID=your-client-id -- npx @leonardocrdso/office365-mcp-server

Manual configuration

Add to your MCP client settings:

{
  "mcpServers": {
    "office365-mcp-server": {
      "command": "npx",
      "args": ["@leonardocrdso/office365-mcp-server"],
      "env": {
        "AZURE_CLIENT_ID": "your-client-id",
        "AZURE_TENANT_ID": "common"
      }
    }
  }
}

Azure AD Setup

1. Go to Azure Portal > Microsoft Entra ID > App registrations
2. Click New registration:
   • Name: Office 365 MCP Server
   • Supported account types: Accounts in any organizational directory (multi-tenant)
   • Redirect URI: leave empty
3. In Authentication: set Allow public client flows to Yes
4. In API permissions > Add permissions > Microsoft Graph > Delegated permissions, add:
   • User.Read
   • Mail.Read, Mail.Send, Mail.ReadWrite
   • Calendars.Read, Calendars.ReadWrite
   • Files.Read.All, Files.ReadWrite.All
   • Sites.Read.All, Sites.ReadWrite.All
   • Team.ReadBasic.All, Channel.ReadBasic.All, ChannelMessage.Send
   • Chat.Read, Chat.ReadWrite
5. Copy the Application (client) ID and use as AZURE_CLIENT_ID

Tools

Auth

| Tool | Description | |------|-------------| | login | Start Device Code Flow authentication — returns a code and URL | | auth-status | Check authentication status and show logged-in user info | | logout | Sign out and remove cached tokens |

Mail

| Tool | Description | |------|-------------| | list-emails | List emails from Outlook (inbox or specific folder) | | search-emails | Search emails by KQL query | | read-email | Read full email content by ID | | send-email | Send a new email | | reply-email | Reply to an existing email | | list-mail-folders | List email folders |

Calendar

| Tool | Description | |------|-------------| | list-events | List calendar events in a date range | | create-event | Create a new event or meeting | | update-event | Update an existing event | | delete-event | Delete an event | | find-free-slots | Check availability for meeting attendees |

OneDrive

| Tool | Description | |------|-------------| | list-drive-files | List files and folders | | read-file-content | Read text file content | | upload-file | Upload a file (up to 4MB text) | | search-files | Search files by text | | share-file | Create a sharing link |

SharePoint

| Tool | Description | |------|-------------| | list-sites | List SharePoint sites | | get-site | Get site details | | list-document-libraries | List document libraries | | list-library-items | List library items | | search-sharepoint | Search SharePoint content |

Teams

| Tool | Description | |------|-------------| | list-teams | List joined teams | | list-channels | List team channels | | list-channel-messages | List channel messages | | send-channel-message | Send a channel message | | list-chats | List direct chats | | send-chat-message | Send a chat message |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | AZURE_CLIENT_ID | Yes | — | App registration client ID | | AZURE_TENANT_ID | No | common | Tenant ID or common for multi-tenant |

Development

# Install dependencies
bun install

# Run in development mode
bun run dev

# Build
bun run build

License

MIT