MCP SERVER

EasyWeek

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

https://mcp.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 Customize
Go to Connectors, click the + button
Enter name (e.g. “EasyWeek”) and paste the URL: https://mcp.easyweek.io/mcp
Log in with your EasyWeek account and authorize 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 coloring 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 coloring?”

Claude calls get_next_available_slot:

Next available: Monday, March 31 at 09:00 (Europe/Berlin)

Service: Hair Coloring — 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	`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
Bookings	`get_booking`	Get booking details
Bookings	`list_booking_statuses`	List available statuses
Customers	`list_customers`	List customers
Customers	`get_customer`	Get customer details
Customers	`get_customer_bookings`	Get customer’s bookings

Write tools

Domain	Tool	Description
Bookings	`create_booking`	Create new booking
Bookings	`complete_booking`	Complete a booking
Bookings	`change_booking_status`	Change booking status
Bookings	`reschedule_booking`	Reschedule booking to new date/time
Bookings	`update_booking_notes`	Update booking notes

Destructive tools

Domain	Tool	Description
Bookings	`cancel_booking`	Cancel a booking

Authentication

The server uses OAuth 2.1 with PKCE. When connecting from an AI tool:

The tool discovers OAuth endpoints via /.well-known/oauth-protected-resource (RFC 9728)
Registers automatically via Dynamic Client Registration (RFC 7591)
Redirects you to EasyWeek login page for authorization
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 authorized EasyWeek company
Token forwarding: OAuth tokens are forwarded to 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
Privacy Policy: easyweek.io/business/terms-and-policies

Support

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