Microsoft 365 Bookings MCP Server

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:
2. Go to Azure Portal > Azure Active Directory > App registrations
3. Create a new registration

4. Add Microsoft Graph API permissions:

   • BookingsAppointment.ReadWrite.All
   • BookingsBusiness.ReadWrite.All
   • BookingsStaffMember.ReadWrite.All

5. 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)