Microsoft 365 MCP Server

The Microsoft 365 MCP Server provides comprehensive integration with Microsoft 365 services, enabling seamless interaction with Outlook email, Calendar, OneDrive, SharePoint, OneNote, Microsoft To Do, Teams, and user management through a unified interface. This server empowers applications to automate workflows, manage communications, organize files, and collaborate across the entire Microsoft 365 ecosystem. With over 45 specialized tools, you can build powerful automations and integrations that streamline productivity and enhance collaboration within your organization.

Overview

This MCP server acts as a bridge between your applications and Microsoft 365 services, providing programmatic access to essential business tools. Whether you need to automate email responses, schedule meetings, manage documents, coordinate team communications, or track tasks, this server delivers the functionality you need through a consistent, well-structured API. The server handles authentication and API complexity, allowing you to focus on building features that matter to your users.

Features and Capabilities

User Management

Access and manage user profiles across your Microsoft 365 organization with comprehensive user directory tools.

Available Tools:

• get_my_profile - Retrieves the current authenticated user's profile information including display name, email, job title, and other directory attributes
• get_user - Fetches detailed profile information for any specific user in the organization
  • Parameters:
    • userIdOrPrincipalName (required): User ID or user principal name (email address)
• search_users - Searches the organization directory for users matching specific criteria
  • Parameters:
    • searchTerm (required): Name or email to search for
    • top (optional): Number of results to return (default: 25)

Email Management (Outlook)

Complete email operations including reading, sending, organizing, and managing messages in user mailboxes.

Available Tools:

• list_messages - Retrieves email messages from the mailbox with flexible filtering and pagination

  • Parameters:
    • folderId (optional): Specific folder ID or well-known name (inbox, sentitems, drafts)
    • top (optional): Number of messages to return (default: 25)
    • filter (optional): OData filter expression for advanced filtering
    • search (optional): Search query to find specific messages
    • orderBy (optional): Sort order (default: receivedDateTime desc)

• get_message - Retrieves complete details of a specific email message

  • Parameters:
    • messageId (required): Unique identifier of the message

• send_email - Sends a new email message with full formatting and attachment support

  • Parameters:
    • to (required): Array of recipient email addresses
    • subject (required): Email subject line
    • body (required): Email body content (HTML or plain text)
    • cc (optional): Array of CC recipient addresses
    • bcc (optional): Array of BCC recipient addresses
    • bodyType (optional): Content type - "Text" or "HTML" (default: HTML)
    • importance (optional): Priority level - "Low", "Normal", or "High"
    • saveToSentItems (optional): Whether to save in sent items (default: true)

• create_draft - Creates a draft email message for later editing and sending

  • Parameters:
    • subject (optional): Email subject
    • body (optional): Email body content
    • to (optional): Array of recipient addresses
    • bodyType (optional): "Text" or "HTML" (default: HTML)

• reply_to_message - Sends a reply to an existing email message

  • Parameters:
    • messageId (required): ID of the message to reply to
    • comment (required): Reply message body

• delete_message - Permanently removes an email message

  • Parameters:
    • messageId (required): ID of the message to delete

• move_message - Moves a message to a different folder

  • Parameters:
    • messageId (required): ID of the message to move
    • destinationFolderId (required): Target folder ID or well-known name

Calendar Management

Full calendar functionality for viewing, creating, updating, and responding to meetings and events.

Available Tools:

• list_calendars - Retrieves all calendars available to the user

• list_events - Lists calendar events with date range filtering

  • Parameters:
    • calendarId (optional): Specific calendar ID (default: primary calendar)
    • startDateTime (optional): Start date/time filter in ISO 8601 format
    • endDateTime (optional): End date/time filter in ISO 8601 format
    • top (optional): Number of events to return (default: 25)

• get_event - Retrieves detailed information about a specific calendar event

  • Parameters:
    • eventId (required): Event identifier

• create_event - Creates a new calendar event or meeting

  • Parameters:
    • subject (required): Event title
    • startDateTime (required): Start time in ISO 8601 format
    • endDateTime (required): End time in ISO 8601 format
    • body (optional): Event description
    • location (optional): Event location
    • attendees (optional): Array of attendee email addresses
    • timeZone (optional): Time zone identifier (default: UTC)
    • isOnlineMeeting (optional): Whether to create as Teams meeting
    • reminderMinutesBeforeStart (optional): Reminder time in minutes

• update_event - Modifies an existing calendar event

  • Parameters:
    • eventId (required): Event ID to update
    • subject (optional): Updated title
    • startDateTime (optional): New start time
    • endDateTime (optional): New end time
    • location (optional): Updated location
    • body (optional): Updated description

• delete_event - Removes a calendar event

  • Parameters:
    • eventId (required): Event ID to delete

• respond_to_event - Responds to a meeting invitation

  • Parameters:
    • eventId (required): Event ID to respond to
    • response (required): Response type - "accept", "tentativelyAccept", or "decline"
    • comment (optional): Optional message to include with response

Contact Management

Organize and manage contacts in your personal and organizational address books.

Available Tools:

• list_contacts - Retrieves contacts from user's contact folders

  • Parameters:
    • top (optional): Number of contacts to return (default: 50)
    • orderBy (optional): Sort field (default: displayName)

• get_contact - Gets detailed information for a specific contact

  • Parameters:
    • contactId (required): Contact identifier

• create_contact - Creates a new contact entry

  • Parameters:
    • givenName (optional): First name
    • surname (optional): Last name
    • emailAddresses (optional): Array of email addresses
    • businessPhones (optional): Array of business phone numbers
    • mobilePhone (optional): Mobile phone number
    • jobTitle (optional): Job title
    • companyName (optional): Company name

• delete_contact - Removes a contact from the directory

  • Parameters:
    • contactId (required): Contact ID to delete

OneDrive File Management

Access, organize, share, and manage files stored in OneDrive for Business.

Available Tools:

• list_drive_items - Lists files and folders in OneDrive

  • Parameters:
    • folderId (optional): Specific folder ID (default: root folder)
    • top (optional): Number of items to return (default: 50)

• get_drive_item - Retrieves metadata for a specific file or folder

  • Parameters:
    • itemId (required): Item identifier

• search_drive_items - Searches for files and folders across OneDrive

  • Parameters:
    • query (required): Search query string
    • top (optional): Number of results (default: 25)

• create_folder - Creates a new folder in OneDrive

  • Parameters:
    • name (required): Folder name
    • parentFolderId (optional): Parent folder ID (default: root)

• delete_drive_item - Deletes a file or folder

  • Parameters:
    • itemId (required): Item ID to delete

• share_drive_item - Creates a sharing link for a file or folder

  • Parameters:
    • itemId (required): Item ID to share
    • type (required): Link type - "view" or "edit"
    • scope (optional): Link scope - "anonymous" or "organization" (default: organization)

SharePoint Integration

Access SharePoint sites, lists, and pages for team collaboration and content management.

Available Tools:

• list_sharepoint_sites - Lists SharePoint sites accessible to the user

  • Parameters:
    • search (optional): Search query to filter sites
    • top (optional): Number of sites to return (default: 25)

• get_site - Retrieves detailed information about a specific SharePoint site

  • Parameters:
    • siteId (required): Site identifier

• list_site_lists - Lists all lists within a SharePoint site

  • Parameters:
    • siteId (required): Site ID

• list_site_pages - Retrieves pages from a SharePoint site

  • Parameters:
    • siteId (required): Site ID

OneNote Integration

Access and read OneNote notebooks, sections, and pages for note-taking and documentation.

Available Tools:

• list_notebooks - Lists all OneNote notebooks available to the user

• list_sections - Lists sections within a notebook

  • Parameters:
    • notebookId (optional): Specific notebook ID (omit to list all sections)

• list_pages - Lists pages within a section

  • Parameters:
    • sectionId (required): Section identifier

• get_page_content - Retrieves the HTML content of a OneNote page

  • Parameters:
    • pageId (required): Page identifier

Microsoft To Do Task Management

Create, update, and manage tasks in Microsoft To Do for personal and team productivity.

Available Tools:

• list_todo_lists - Retrieves all task lists in Microsoft To Do

• list_tasks - Lists tasks within a specific task list

  • Parameters:
    • listId (required): Task list identifier
    • filter (optional): OData filter expression (e.g., "status ne 'completed'")

• create_task - Creates a new task in a To Do list

  • Parameters:
    • listId (required): Task list ID
    • title (required): Task title
    • body (optional): Task description
    • dueDateTime (optional): Due date/time in ISO 8601 format
    • reminderDateTime (optional): Reminder date/time in ISO 8601 format
    • importance (optional): Priority - "low", "normal", or "high"

• update_task - Updates an existing task

  • Parameters:
    • listId (required): Task list ID
    • taskId (required): Task identifier
    • title (optional): Updated title
    • status (optional): Task status - "notStarted", "inProgress", or "completed"
    • importance (optional): Priority level

Microsoft Teams Collaboration

Interact with Teams channels and messages for enhanced team communication and collaboration.

Available Tools:

• list_teams - Lists all teams where the user is a member

• list_channels - Lists channels within a specific team

  • Parameters:
    • teamId (required): Team identifier

• list_channel_messages - Retrieves messages from a team channel

  • Parameters:
    • teamId (required): Team ID
    • channelId (required): Channel ID
    • top (optional): Number of messages to return (default: 50)

• send_channel_message - Posts a message to a Teams channel

  • Parameters:
    • teamId (required): Team ID
    • channelId (required): Channel ID
    • content (required): Message content in HTML format

Use Cases

This MCP server enables a wide range of automation and integration scenarios:

• Email Automation: Automatically process incoming emails, send notifications, manage support tickets, and organize messages based on content or sender
• Meeting Management: Schedule meetings, send invitations, manage attendee responses, and coordinate team calendars
• Document Workflows: Organize files, create folder structures, share documents with team members, and manage document lifecycles
• Task Tracking: Create tasks from emails, sync to-do items across systems, and track project progress
• Team Collaboration: Post updates to Teams channels, monitor conversations, and integrate with other business systems
• Contact Synchronization: Keep contact information up-to-date across platforms and maintain unified address books
• Note Organization: Access OneNote content for knowledge management and documentation systems
• SharePoint Content Management: Access team sites, manage lists, and coordinate on shared resources

Getting Started

Once configured with proper Microsoft 365 authentication, you can immediately start using any of the 45+ tools provided by this server. The server handles all the complexity of Microsoft Graph API authentication, pagination, and error handling, providing you with clean, consistent interfaces for all Microsoft 365 services.

Each tool accepts JSON-formatted parameters and returns structured data that's easy to work with in your applications. The server supports both simple operations like retrieving your profile and complex workflows like creating calendar events with multiple attendees and online meeting links.

This MCP server transforms Microsoft 365 from a collection of separate services into a unified, programmable platform that can be seamlessly integrated into your workflows, applications, and automation scripts.