# Calenso MCP MCP > Calenso MCP connects your AI agent directly to appointment scheduling, client records, and staff availability for service businesses and clinics. Use it to check staff schedules, list all customers, create new profiles, or cancel appointments—all through natural conversation. It manages complex booking logic without you ever leaving your chat interface. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** appointment-booking, customer-directory, staff-availability, online-scheduling, booking-management ## Description Managing a clinic schedule means juggling several systems: the appointment book, the client database, and the internal service catalog. This MCP lets your AI agent handle that friction for you. Instead of manually logging into separate portals to check who's free or finding a customer's last visit details, you just ask your agent. It talks to Calenso’s core systems—listing appointments, checking staff availability across different branches, or even building out a new client record from a quick chat exchange. The whole process runs on the reliable infrastructure of Vinkius, making it available to any MCP-compatible client. You get instant visibility into services and staff members, allowing you to manage bookings and client data entirely through your preferred AI workflow. ## Tools ### cancel_calenso_appointment Cancels a specific appointment by ID. ### create_calenso_customer Creates a new customer profile in the system. ### get_calenso_appointment Retrieves full details for one specific appointment. ### list_calenso_appointments Lists multiple upcoming appointments based on filters or dates. ### list_calenso_branches Lists all physical office locations or branches. ### list_calenso_customers Retrieves a list of existing customer records. ### list_calenso_services Lists all bookable services offered by the business. ### list_calenso_staff Retrieves a list of staff members and their roles. ## Prompt Examples **Prompt:** ``` List all my upcoming Calenso appointments. ``` **Response:** ``` Here is the information you requested based on the execution of the tools. ``` **Prompt:** ``` Cancel appointment ID 88392. ``` **Response:** ``` Here is the information you requested based on the execution of the tools. ``` **Prompt:** ``` List the bookable services and staff members. ``` **Response:** ``` Here is the information you requested based on the execution of the tools. ``` ## Capabilities ### Check Staff and Service Availability Get a list of bookable services, available branches, or specific staff members' open times. ### Manage Client Records Query existing customer profiles or automatically create new ones using conversational inputs. ### Review and Change Appointments List upcoming appointments, fetch specific details on a booking, or cancel an appointment ID with one prompt. ## Use Cases ### Rescheduling a Client Visit A client calls saying they need to move their appointment. Instead of having the coordinator look up the ID, they just tell the agent: 'Cancel my booking for next Tuesday.' The agent uses `cancel_calenso_appointment` and then prompts the user to rebook using available services. ### Onboarding a New Company The operations team needs a list of all current clients in one place. They simply ask, 'Give me the roster,' triggering `list_calenso_customers`, eliminating spreadsheet exports and database queries. ### Planning Staff Coverage A manager has to confirm if enough staff are available across multiple locations next month. They use this MCP to run `list_calenso_staff` and then check the service offerings at different branches using `list_calenso_branches` and `list_calenso_services`. ### Initial Client Intake A new client is speaking with a representative. The rep needs to create their profile immediately. They prompt the agent, 'Add a new customer named John Doe,' which executes `create_calenso_customer` instantly. ## Benefits - Stop manually cross-referencing calendars. Use `list_calenso_appointments` to see all upcoming bookings in one query, regardless of which staff member is involved. - Building a new client record used to involve multiple forms and fields. Now, use `create_calenso_customer` to add a full profile just by asking your agent conversational questions. - Need to know if you can book someone today? Instead of calling the office, ask for staff availability; this MCP lets you run through `list_calenso_staff` and check service times instantly. - Cancel a booking or need details on an old one? You don't have to guess the ID. Use `get_calenso_appointment` or `cancel_calenso_appointment` by simply stating what needs fixing. - Don’t waste time checking if your business has moved locations. Quickly query all available sites using `list_calenso_branches` and then check which services are offered there via `list_calenso_services`. ## How It Works The bottom line is, you don't have to switch between apps; your agent handles the Calenso backend calls for you. 1. Retrieve your API key from the Calenso portal. 2. Plug that API key into this integration within Vinkius. 3. Tell your AI agent what you need to do, like 'List all appointments for tomorrow' or 'Add a new client.' ## Frequently Asked Questions **How do I list all my appointments with the Calenso MCP?** You use the `list_calenso_appointments` tool. This allows you to retrieve a comprehensive list of upcoming bookings, which is useful for giving clients an overview of their schedule. **Can I create a new customer using the Calenso MCP?** Yes, use the `create_calenso_customer` tool. You can pass necessary information to this function directly through your chat prompt, letting your agent handle the data entry for you. **What is the best way to check staff availability with Calenso MCP?** To see who's working and what they offer, run `list_calenso_staff` followed by checking services using `list_calenso_services`. This gives a complete picture of human resources and offerings. **Does the Calenso MCP help me find branch locations?** Absolutely. The `list_calenso_branches` tool pulls all active physical locations. You can then narrow down services or staff based on those specific sites. **What do I need to do before running `list_calenso_appointments`?** You must first connect your API key within the Vinkius client. The MCP needs this credential to authenticate and talk to Calenso's live system. Once connected, you can then ask your agent to list appointments for any date range. **If I try to use `cancel_calenso_appointment` on an invalid ID, what happens?** The MCP will return a specific error code indicating the appointment ID doesn't exist or isn't active. This helps your agent immediately inform you that the booking cannot be cancelled because of bad input data. **After running `list_calenso_customers`, how do I get full details for a profile?** The list tool gives you an overview, but you need to reference specific customer IDs in your prompt. Your agent then uses those IDs to fetch the complete contact history and detailed records. **How can I use `list_calenso_services` to verify available offerings?** Simply ask your AI client to list services using this tool name. It pulls a dynamic catalog of all bookable services, letting you verify what the clinic offers before attempting to schedule anything.