# EasyWeek (verified)

EasyWeek is an all-in-one booking and business management platform for salons, clinics, studios, and other appointment-based businesses across Europe and beyond. This MCP server exposes your EasyWeek…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add easyweek/easyweek

# Browse available tools
npx -y @smithery/cli@latest tool list easyweek/easyweek

# Get full schema for a tool
npx -y @smithery/cli@latest tool get easyweek/easyweek get_workspace

# Call a tool
npx -y @smithery/cli@latest tool call easyweek/easyweek get_workspace '{}'
```

## Direct MCP Connection

Endpoint: `https://easyweek-mcp.run.tools`

## Tools (22)

- `get_workspace` — Get information about the current workspace (company).
- `list_locations` — List all locations (branches) of the company.
- `get_location` — Get address, contact details, and settings for a specific location.
- `list_staff` — List staff members working at a location with their roles and assigned services.
- `list_staff_categories` — List staff categories (departments/roles) configured at a location.
- `list_services` — List services offered at a location with prices, durations, and assigned staff.
- `list_service_categories` — List service categories at a location. Use to group services when displaying to users.
- `list_payment_accounts` — List payment accounts (cash, card, online) configured for a location.
- `get_availability` — List available time slots for a service within a date range.
- `get_next_available_slot` — Find the earliest available time slot for a service. Use when a user asks 'when can I book?'.
- `list_bookings` — List bookings for the workspace, paginated, with status, customer, services, and times.
- `get_booking` — Get full booking details: customer, services, order amount, status, and cancellation policy.
- `create_booking` — Create a new booking (appointment). Verify slot availability with get_availability first.
- `cancel_booking` — Cancel a booking. This is a destructive action — confirm with the user before calling.
- `complete_booking` — Mark a booking as completed (service delivered successfully).
- `change_booking_status` — Move a booking to a custom status (e.g. 'Confirmed', 'No-show'). Use list_booking_statuses first.
- `update_booking_notes` — Replace the public comment/notes on a booking. Visible to staff and in client notifications.
- `reschedule_booking` — Move a booking to a new date/time. Preserves customer, services, and payment; only the time changes.
- `list_booking_statuses` — List booking statuses available in this workspace. Use to resolve status UUIDs for change_booking_status.
- `list_customers` — List customers in the workspace, paginated, with names, contacts, and profile fields.
- `get_customer` — Get full customer details: name, phone, email, birthday, company info, and messaging contacts.
- `get_customer_bookings` — Get booking history for a customer, paginated, sorted by date descending (newest first).

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get easyweek/easyweek <tool-name>
```

## Prompts (3)

- `book_appointment` (service, when, customer) — Guide the user through booking a new appointment end-to-end.
- `find_next_slot` (service) — Find the earliest free time slot for a service.
- `check_today_schedule` — Show the list of bookings scheduled for today.
