MCP SERVER

EasyWeek

MCP server for the EasyWeek booking platform. Manage bookings, clients, services, staff, and locations through AI.

https://mcp-next.easyweek.io/mcp

Features

22 MCP tools across 6 domains: Bookings, Staff, Clients, Services, Locations, Availability
OAuth 2.1 with PKCE — connects to a specific EasyWeek company
Dynamic Client Registration (RFC 7591) — AI tools register automatically
Safety annotations on every tool (readOnlyHint, destructiveHint)
Stateless HTTP transport — compatible with Claude, ChatGPT, Cursor, and any MCP client

Connect to Claude.ai

Open claude.ai, click the menu icon (bottom-left), then Customise
Go to Connectors, click the + button
Enter a name (e.g. “EasyWeek”) and paste the URL: https://mcp.easyweek.io/mcp
Log in with your EasyWeek account and authorise access
Ask Claude to manage your bookings, clients, and schedule

Examples

Example 1: Check today’s schedule

User: “Show me all bookings for today”

Claude calls list_bookings and returns:

You have 3 bookings today:
10:00 — Haircut with John Doe (confirmed)
13:00 — Hair colouring with Jane Smith (new)
16:30 — Haircut with Mike Brown (confirmed)

Example 2: Book an appointment

User: “Book a haircut for Anna Mueller, +49123456789, tomorrow at 14:00”

Claude calls get_availability to verify the slot, then create_booking:

Booking created for Anna Mueller:
Service: Haircut — 10.00 EUR
Date: March 31, 2026 at 14:00 (Europe/Berlin)
Status: New

Example 3: Find next available slot

User: “When is the next available slot for hair colouring?”

Claude calls get_next_available_slot:

Next available: Monday, March 31 at 09:00 (Europe/Berlin)
Service: Hair Colouring — 120 min, 21.00 EUR

Available Tools

Read-only tools

Domain	Tool	Description
Workspace	`get_workspace`	Get current company info
Locations	`list_locations`	List all locations
Locations	`get_location`	Get location details
Staff	`list_staff`	List staff at location
Staff	`list_staff_categories`	List staff categories
Services	`list_services`	List services at location
Services	`get_service`	Get service details
Services	`list_service_categories`	List service categories
Services	`list_payment_accounts`	List payment accounts
Availability	`get_availability`	Get available time slots
Availability	`get_next_available_slot`	Get next available slot
Bookings	`list_bookings`	List bookings with date, location, staff and status filters
Bookings	`get_booking`	Get booking details
Bookings	`list_booking_statuses`	List available statuses
Customers	`list_customers`	List customers
Customers	`find_customer`	Find a customer by phone or email
Customers	`get_customer`	Get customer details
Customers	`get_customer_bookings`	Get customer's bookings
Orders	`list_orders`	List point-of-sale orders
Orders	`get_order`	Get order details
Goods	`list_goods`	List products (goods)
Vouchers	`list_voucher_templates`	List gift voucher templates
Messaging	`get_messaging_balance`	Wallet balances, limits and auto-reload
Messaging	`get_message_history`	Sent messages with delivery status
Messaging	`get_message_status`	One sent message with its status
Messaging	`check_phone`	Can a phone number receive SMS
Reminders	`list_reminders`	Automatic reminders with status and channel
Reminders	`get_reminder_templates`	Templates of a reminder per channel and locale
Reminders	`get_moderation_status`	Templates waiting for moderation

Write tools

Domain	Tool	Description
Bookings	`create_booking`	Create new booking
Bookings	`create_blocked_spot`	Block time on a staff member's calendar
Customers	`create_customer`	Create a customer
Orders	`create_order`	Create a point-of-sale order
Services	`create_service`	Create a service
Vouchers	`create_voucher_template`	Create a gift voucher template

Destructive tools

Domain	Tool	Description
Bookings	`cancel_booking`	Cancel a booking
Bookings	`complete_booking`	Complete a booking
Bookings	`change_booking_status`	Change booking status
Bookings	`reschedule_booking`	Reschedule booking to new date/time
Bookings	`change_booking_staffer`	Reassign a booking to another staff member
Bookings	`replace_booking_service`	Replace the service of a booking
Bookings	`update_booking_notes`	Update booking notes
Customers	`update_customer`	Update a customer's details and messaging contacts
Orders	`refund_order`	Refund a paid order
Orders	`pay_order`	Pay an open order
Services	`update_service`	Update a service
Messaging	`set_autoreload`	Configure automatic wallet top-up
Reminders	`enable_reminder`	Turn a reminder on
Reminders	`pause_reminder`	Pause a reminder
Reminders	`update_reminder_template`	Set channel and texts of a reminder (moderated)

Authentication

The tool discovers OAuth endpoints via /.well-known/oauth-protected-resource (RFC 9728)
Registers automatically via Dynamic Client Registration (RFC 7591)
Redirects you to the EasyWeek login page for authorisation
Receives an access token scoped to your company

No API keys needed — just log in with your EasyWeek account.

Privacy & Security

Data access: The MCP server can only access data belonging to the authorised EasyWeek company
Token forwarding: OAuth tokens are forwarded to the EasyWeek API — the MCP server does not store tokens
HTTPS: All connections use TLS encryption
GDPR: EasyWeek GmbH is a German company with servers in Germany. All data processing complies with GDPR/DSGVO

easyweek.io/business/terms-and-policies

Support

Email: support@easyweek.io
Website: easyweek.io