Calenso MCP for AI. Schedule appointments, manage clients, check availability.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
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.
What your AI can do
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.
Get a list of bookable services, available branches, or specific staff members' open times.
Query existing customer profiles or automatically create new ones using conversational inputs.
List upcoming appointments, fetch specific details on a booking, or cancel an appointment ID with one prompt.
Ask an AI about this
Waiting for input…
Calenso: 8 Tools for Scheduling & Clients
Use these tools to programmatically create, read, update, and delete core data points like customer records, appointments, services, and staff listings.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Calenso on VinkiusCancel 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.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The Calenso integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Calenso, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Calenso. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 8 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Checking schedules and client details is a multi-step, manual process today.
Right now, if a coordinator needs to book someone, they might start by checking the central calendar system. Then, they have to open the staff directory to confirm who's on duty at that specific branch. If that doesn't work, they jump over to the CRM tool to verify the client’s billing status before finally calling the service catalog to see what services are even offered.
With this MCP, you just ask your agent: 'Can I book a massage for Jane Doe next Thursday?' The system handles checking staff availability, verifying the branch location, and confirming the service exists—all in one conversational flow. You get an immediate answer instead of three different loading screens.
The Calenso MCP delivers unified access to client data.
Previously, updating a customer record or canceling an appointment meant jumping between the CRM platform and the calendar system. You'd have to copy IDs from one screen and paste them into another, increasing friction and errors.
Now, you speak directly to your agent. It finds the client using their name, confirms the appointment ID, executes the cancellation via `cancel_calenso_appointment`, and sends confirmation—all without leaving the chat window. The process is seamless.
What your AI can actually do with this
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.
019dd0c8-b99f-7178-a2b0-95af0dd06847 
Here's how it actually works
The bottom line is, you don't have to switch between apps; your agent handles the Calenso backend calls for you.
Retrieve your API key from the Calenso portal.
Plug that API key into this integration within Vinkius.
Tell your AI agent what you need to do, like 'List all appointments for tomorrow' or 'Add a new client.'
Who is this actually for?
Anyone running a service-based business—from independent consultants and small clinics to field service teams. You need this if switching between scheduling software, CRM tools, and internal staff directories slows down your day.
Needs to instantly check which specific staff member is available at a remote branch and book an appointment without manually checking three different calendars.
Has to rapidly verify service availability or create new customer profiles when field teams are calling in from various locations.
Manages the entire client lifecycle, handling everything from listing current clients to canceling old appointments based solely on incoming emails or chat messages.
What Changes When You Connect
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.
See it in action
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.
The honest tradeoffs
Treating tools individually
Asking your agent to first call list_calenso_branches, then asking for services, and finally manually picking the right one. This is slow and requires too many steps.
Ask a single question: 'What are the top three services offered at the downtown branch?' The MCP handles calling list_calenso_branches and filtering service data internally to give you the answer directly.
Assuming manual database access
Trying to manually search for a client's history by guessing their ID or name, which often fails.
Just ask your agent: 'Find my records.' The system uses list_calenso_customers and the AI handles the fuzzy matching across names and details.
Ignoring appointment status
Assuming an appointment exists when it's actually been canceled or rescheduled, leading to wasted time.
Always start by asking your agent to check current bookings using list_calenso_appointments. This verifies the record is active before you try to modify anything.
When It Fits, When It Doesn't
Use this MCP if your primary bottleneck is switching context. If scheduling, client management, and staff availability are all separate systems that currently require different logins or multiple manual steps, this is what you need. It turns a multi-system process into a single chat command.
Don't use it if you only need to do one thing (e.g., just check services) and have no client integration; in that case, a simple standalone API call might be cleaner. Also, don't rely on this for data analysis or reporting beyond listing records—it manages transactions, not deep analytics. For complex financial modeling or historical trend tracking, you still need specialized BI tools.
Questions you might have
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.
Can I cancel a booking directly from the chat? +
Yes. Provide the Appointment ID to the 'cancel_calenso_appointment' tool, and the AI agent will remove it from your schedule.
How do I add a new customer profile? +
Invoke the 'create_calenso_customer' tool with a JSON object containing the customer's details (like name and email).
Is it possible to query available staff members? +
Yes, just use the 'list_calenso_staff' tool to pull the active roster of your bookable employees.
We've already built the connector for Calenso. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 8 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.