YCLIENTS MCP server
YCLIENTS MCP Server
An MCP server for the YCLIENTS booking platform: services, staff, clients, appointments and analytics for salons and service businesses
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- Can create, edit and delete clients, staff and appointments
- The partner and user tokens grant broad access to the company's YCLIENTS data
Install
Manual install
uv syncInstalls dependencies after cloning the repository.
This is third-party code. Review the repository files before installing.
What it does
The server wraps the YCLIENTS REST API with more than thirty tools across seven areas: companies, services and their categories, staff and positions, client search and records with visit history, service appointments, the full online booking flow from available dates and slots to creating a booking, staff schedules and workload, and analytics with daily revenue, a Z-report and appointment breakdowns by source and status. A client-side rate limit of 5 requests per second and 200 per minute keeps it within API limits. The server runs over stdio locally or as an HTTP service, with a ready integration and panel config for Timeweb Cloud AI agents.
Who it is for. For owners of salons, clinics and service businesses on YCLIENTS who want to manage bookings, clients and analytics through an agent.
Good fit when
- You want to quickly create or change a client's service appointment
- You need analytics on revenue, workload or appointment sources for a period
- You want to find the nearest available slots for a specific staff member
Not a fit when
- You do not have a YCLIENTS partner token, issued through the YCLIENTS marketplace
- You do not want to grant an agent the ability to delete staff, clients and records: these tools have no separate read-only restriction
Example request
Create a booking for a client's haircut tomorrow at 2pm and show last week's revenueLimitations
The project has a single author, and the README's clone command still has a YOUR_USERNAME placeholder instead of the real path. It needs a partner token, and some operations additionally need a user token. The README does not detail token permissions or which tools work without admin rights.
How to disable. Stop the server process or container and remove it from your MCP client config or the Timeweb AI agents panel.
MCP
- Transport
- stdio, http
- Authentication
- API key
| Environment variables | |
|---|---|
| YCLIENTS_PARTNER_TOKEN required, secret | Partner token, issued through the YCLIENTS marketplace. |
| YCLIENTS_USER_TOKEN secret | User token, needed for some operations. |
Security check
- Can create, edit and delete clients, staff and appointments
- The partner and user tokens grant broad access to the company's YCLIENTS data
README in short
The Russian README lists more than thirty tools across companies, services, staff, clients, records, online booking, schedules and analytics, gives installation via uv or pip, stdio and HTTP launch, a Docker run and step-by-step Timeweb Cloud AI agents panel setup. It separately notes client-side rate limiting and a recommendation not to store tokens in code.
FAQ
Can the server run in Docker?
Yes, there is a Dockerfile, built with docker build -t yclients-mcp-server . and run with the YCLIENTS_PARTNER_TOKEN and YCLIENTS_USER_TOKEN variables.
Is Timeweb Cloud integration supported?
Yes, the README describes connecting the deployed server in the Timeweb Cloud panel's AI agents, MCP servers section over HTTP.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
Yandex Kit skills for store management
kit-skills
Yandex's official skill set: catalog, prices, stock, orders, storefront and a weekly checkup for a Yandex Kit store, through Claude Code or Codex
YouGile MCP by Indalo
YouGile MCP
Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit
Bitrix24 portal MCP server
MCP-сервер портала Битрикс24
Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail