m365-bookings-mcp

m365-bookings-mcp

0
calendar_managementcloud_platforms

This project is an MCP server designed to facilitate interactions with Microsoft Bookings via the Microsoft Graph API. It includes features for listing businesses, retrieving staff members, services, and appointments.

Microsoft 365 Bookings MCP Server

smithery badge

An MCP server that provides tools for interacting with Microsoft Bookings through the Microsoft Graph API.

Features

  • List Bookings businesses
  • Get staff members for a business
  • Get services offered by a business
  • Get appointments for a business

Setup

Installing via Smithery

To install Microsoft 365 Bookings for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @DynamicEndpoints/m365-bookings-mcp --client claude

Manual Installation

  1. Create an Azure AD application registration:

    • Go to Azure Portal > Azure Active Directory > App registrations
    • Create a new registration
    • Add Microsoft Graph API permissions:
      • BookingsAppointment.ReadWrite.All
      • BookingsBusiness.ReadWrite.All
      • BookingsStaffMember.ReadWrite.All

  2. Create a .env file with the following variables:

MICROSOFT_GRAPH_CLIENT_ID=your-client-id
MICROSOFT_GRAPH_CLIENT_SECRET=your-client-secret
MICROSOFT_GRAPH_TENANT_ID=your-tenant-id
  1. Install dependencies:
npm install
  1. Build the server:
npm run build

Available Tools

get_bookings_businesses

Get a list of all Bookings businesses in the organization.

get_business_staff

Get staff members for a specific Bookings business.

  • Required parameter: businessId

get_business_services

Get services offered by a specific Bookings business.

  • Required parameter: businessId

get_business_appointments

Get appointments for a specific Bookings business.

  • Required parameter: businessId
  • Optional parameters:
    • startDate (ISO format)
    • endDate (ISO format)