# Bookeo MCP

> Bookeo MCP handles your entire fitness or activity business through natural conversation. Check real-time availability for classes and tours, find customer profiles, track revenue from payments, and list every scheduled booking without leaving your chat window.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** online-booking, appointment-scheduling, customer-management, payment-tracking, availability-management, service-automation

## Description

This connector connects to Bookeo, giving you control over every aspect of a scheduling-based business—from personal training studios to large activity centers. You can ask your agent for specific details: 'Who is booked tomorrow?' or 'How much revenue did we bring in yesterday?'. It gathers client data, monitors product capacity, and tracks payment status all from one place. Instead of jumping between booking software, spreadsheets, and accounting tools, you talk to your AI client, which accesses the entire Bookeo catalog via Vinkius. This lets you manage everything—bookings, products, customers, payments, and availability—using simple conversation.

## Tools

### list_bookings
Lists all reservations, including participant count, product name, price, and payment status. You can filter by date range.

### get_booking
Retrieves the specific details of a single, existing booking.

### list_products
Retrieves all available services and products, showing their pricing, duration, and capacity limits.

### search_customers
Finds customer profiles by name or criteria, returning their booking history and preferences.

### get_customer
Fetches a specific client's profile and details.

### list_payments
Generates a list of payments that you can filter by a specific date to analyze revenue.

### check_availability
Determines available time slots for any bookable product in real-time.

### get_business_info
Pulls core configuration data about your entire business account.

### list_webhooks
Shows a list of currently active event notifications set up for your business.

## Prompt Examples

**Prompt:** 
```
Are there any open slots for yoga tomorrow?
```

**Response:** 
```
Available yoga slots tomorrow:

🧘 **7:00 AM** Sunrise Yoga — 4 spots left (6/10)
🧘 **10:00 AM** Gentle Flow — 8 spots left (2/10)
🧘 **5:30 PM** Power Yoga — 2 spots left (8/10) ⚡
🧘 **7:00 PM** Yin Yoga — 6 spots left (4/10)

The 5:30 PM Power Yoga is almost full — only 2 spots remaining!
```

**Prompt:** 
```
Extract the customer profile and booking history for Alice Smith.
```

**Response:** 
```
Profile fetched. Alice Smith joined 8 months ago. She holds 15 past bookings consisting mostly of Pilates sessions, and has completed all mandatory payments. No future classes booked.
```

**Prompt:** 
```
Check total revenue collected for today's classes.
```

**Response:** 
```
Calculating via Bookeo Payments matrix. Today's sessions collected $1,450.00 across 33 unique participants and 4 scheduled classes.
```

## Capabilities

### Check real-time open slots
Find out exactly when a class or service is available based on capacity.

### Search for client records
Pull up any customer's profile, including their full history and preferences.

### View scheduled events
List all upcoming bookings and reservations, detailing the participant count and payment status.

### Analyze income reports
Track total revenue collected by filtering payments by date or method.

### Get business configuration details
Access core information about your studio, like the timezone and operational profile.

## Use Cases

### The Trainer needs to check a client's status
A personal trainer needs to know if a client is overdue for a session. They ask their agent, and the agent uses `get_customer` to pull up the profile, showing recent activity and past payments immediately.

### The Manager needs daily revenue totals
It's end of day. The manager asks for total income today. The agent runs `list_payments`, providing a summarized report that verifies the cash register count against digital sales.

### Booking a large group event
A corporate team needs to book 20 people for an off-peak tour. The coordinator first uses `check_availability` to confirm space, then runs `list_bookings` to reserve the slots and track participant details.

### Auditing business setup
The IT team needs to verify all current integrations are running. They use `list_webhooks` to see a manifest of every active notification, ensuring no critical connection has failed.

## Benefits

- Never manually check a calendar again. Use the `check_availability` tool to instantly know open slots for any class or service, freeing up time otherwise spent on back-and-forth emails.
- Get full visibility into client accounts using `search_customers`. You can pull up a client's profile and entire booking history without ever switching out of your chat interface.
- Stop guessing about money. Running the `list_payments` tool gives you filtered revenue reports, letting you track earnings and identify trends for better cash flow management.
- Need to know what services you offer? The `list_products` tool details everything—pricing, duration, and capacity—so your agent always has the current catalog information.
- Quickly verify a client's status by calling `get_customer`. You get their full record instantly, so you can address issues with confidence.

## How It Works

The bottom line is you get instant, conversational access to operational data without logging into any separate dashboard.

1. Connect your preferred AI client to this MCP.
2. Ask your agent a specific question, such as 'What are the open slots for yoga tomorrow?'
3. The agent uses the necessary tool calls and returns structured data detailing availability or records.

## Frequently Asked Questions

**How do I check availability with the `check_availability` tool?**
Simply ask your agent for open slots and specify the product name and date. The tool returns real-time data showing exactly how many spots are left across all available times.

**What information does the `list_payments` tool provide?**
The `list_payments` tool provides a filterable list of transactions, allowing you to analyze revenue by date and track payment methods used during that time period.

**Can I find a client's history using the `search_customers` tool?**
Yes. Use `search_customers` with the name or ID, and the agent pulls up their full profile, including past bookings and stored preferences.

**Does `get_business_info` show my current pricing?**
No, that tool retrieves core business settings like your timezone and account status. For product prices, use the `list_products` tool instead.

**What time filters can I apply when using the `list_bookings` tool?**
You can filter bookings by specific date ranges. The tool allows you to define a start and end date, which lets your agent retrieve all reservations within that window.

**Does running `get_customer` provide payment data or just profile info?**
It returns the client's core profile details. Payment history is managed separately; for revenue tracking, you should use the dedicated list payments tool instead.

**When I run `list_products`, what information do I get about each bookable item?**
The tool provides essential operational data: pricing, how long the product lasts (duration), and its maximum capacity. This helps you understand resource limits.

**How does the `list_webhooks` tool help with system monitoring?**
It shows all currently active event notifications tied to your account. Checking this list confirms that your integration points are correctly set up and receiving data when needed.

**How do I get Bookeo API credentials?**
Create a developer account at bookeo.com/apiref, register your application, and you'll receive an API Key and Secret Key. Bookeo provides an OpenAPI/Swagger specification for easy integration.

**Can I cancel customer bookings directly via this tool?**
Yes. Assuming the API user has write permissions, your AI can look up a customer profile and issue a cancellation or reschedule their slots instantly.

**Does it track revenue generated from daily sales?**
Bookeo MCP provides full payment read endpoints. You can instruct your AI to retrieve transactions from the last 24 hours and summarize daily earnings.