Calendesk MCP服务器
连接你的 日历 Claude、Claude Desktop、Claude Code和其他兼容MCP的人工智能工具的预订平台。通过自然语言管理预订、客户、员工、服务和查看业务分析。
先决条件
- A. 日历 账户
设置
第ai条（推荐）
不需要安装或API密钥。使用OAuth进行安全身份验证。
- 首选 设置→ 连接器 在Claude.ai
- 点击 添加自定义连接器
- 输入：
- 姓名： 日历 - 远程MCP服务器URL: https://mcp.calendesk.com
- 点击 添加
- 出现提示时，使用您的Calendesk凭据登录
克劳德桌面版
添加到配置文件(~/.config/claude/claude_desktop_config.json 在macOS/Linux上， %APPDATA%\Claude\claude_desktop_config.json 在Windows上）：
{
"mcpServers": {
"calendesk": {
"url": "https://mcp.calendesk.com",
"headers": {
"X-Api-Key": "your-api-key",
"X-Tenant": "your-tenant-id"
}
}
}
}在中生成API密钥 管理面板→ 设置→ API.
克劳德代码
claude mcp add calendesk https://mcp.calendesk.com \
--transport http \
--header "X-Api-Key: your-key" \
--header "X-Tenant: your-tenant"其他MCP客户端（STDIO代理）
对于不支持HTTP传输的客户端：
pip install calendesk-mcp-server
# or: uvx calendesk-mcp-server{
"mcpServers": {
"calendesk": {
"command": "uvx",
"args": ["calendesk-mcp-server"],
"env": {
"CALENDESK_API_KEY": "your-api-key",
"CALENDESK_TENANT": "your-tenant-id"
}
}
}
}支持的工具
预订
list_bookings-使用可选过滤器列出预订/约会get_booking-通过ID获取特定预订的详细信息create_booking-创建新的预订/预约update_booking-更新现有预订delete_booking-删除预订get_group_booking-获取团体预订的详细信息check_event_overlaps-检查日程安排冲突
客户
search_users-按姓名、电子邮件或电话搜索客户get_user-按ID获取客户详细信息list_users-列出所有具有可选筛选功能的客户create_user-创建新客户update_user-更新客户信息delete_user-删除客户
员工
list_employees-列出所有员工/职员get_employee-获取员工详细信息delete_employee-删除员工
服务和可用性
list_services-列出所有可用服务get_service-获取服务详细信息，包括持续时间、价格和地点get_available_slots-获取可用的预订时段list_availability-获取可用性时间表/工作时间get_availability-获取具体的可用性时间表list_service_types-获取所有服务类别list_products-获取所有可供销售的产品list_tags-获取所有可用标签list_user_groups-获取所有客户群
分析与统计
get_dashboard_stats-获取仪表板KPI（收入、预订、客户、取消）get_revenue_report-获取按来源细分的收入分析get_booking_analytics-按状态、趋势和服务获取预订分析get_employee_performance-获取员工绩效比较get_service_analytics-获取服务流行度指标get_customer_insights-获取客户分析和细分（首次、再次、忠诚）get_booking_patterns-获取基于时间的预订模式和高峰时段get_payment_analytics-获取付款和交易分析get_subscription_analytics-获取订阅指标和续订率get_location_analytics-获取位置和交付类型分析get_product_analytics-获取产品销售分析get_revenue_forecast-获取未来1-3个月的收入预测
设置和通知
get_settings-获取业务设置（时区、货币、公司信息）get_me-获取当前用户资料和员工信息send_notification-发送电子邮件、短信或推送通知
示例
查看今天的日程安排
你： “我今天的日程安排怎么样？”
助理打来电话 list_bookings 今天的日期和回报：
您今天有4个约会： |时间|服务|客户|状态| |------|---------|----------|--------| |09:00–10:00 |理发|玛丽亚·科瓦尔斯基|已批准| |10:30-11:30 |染发|安娜·维希涅夫斯卡|已批准| |13:00–14:00 |理发| Jan Nowak |已批准| |15:00–16:00 |胡子修剪|托马什·齐林斯基|已批准|
查找可用时段并预约
你： “我下周什么时候可以安排与科瓦尔斯基医生进行60分钟的咨询？”
助理打来电话 get_available_slots 对于服务和员工，则响应：
科瓦尔斯基博士下周有以下职位空缺： 星期一： 09:00, 11:00, 14:00 星期二： 10:00, 13:00, 15:00 星期四： 09:00, 11:00 你想让我订一个吗？
你： “周一11:00为客户预订anna@example.com"
助理打来电话 search_users 找到客户，然后 check_event_overlaps 验证无冲突，最后 create_booking:
预订已确认： - 服务： 咨询（60分钟） - 员工： 科瓦尔斯基博士 - 客户： 安娜·维希涅夫斯卡(anna@example.com) - 什么时候： 3月17日星期一11:00–12:00 - 预订ID: #4521
查看业务绩效
你： “与前一个月相比，上个月生意怎么样？”
助理打来电话 get_dashboard_stats 日期范围：
2026年2月与2026年1月： |度量|二月|变化| |--------|----------|--------| |收入| 12500欧元|+8.5%| |预订|285 |+12| |新客户|18|+5| |取消率|3.5%|-0.8pp| 收入呈上升趋势，主要原因是染发预订量增加（+22%）。
搜索客户
你： “为我查找客户Kowalska的联系信息”
助理打来电话 search_users:
找到2个匹配项： 1. 玛丽亚·科瓦尔斯基 — maria@example.com，+48 512 345 678（最后访问时间：3月5日） 1. 伊娃 科瓦尔斯卡 — ewa.k@example.com，+48 601 234 567（最后访问时间：2月12日）
发送通知
你： “向Maria Kowalska发送电子邮件提醒她明天的预约”
助理打来电话 send_notification:
电子邮件已发送给Maria Kowalska(maria@example.com)并提醒她明天09:00要去理发。
环境变量（仅限STDIO模式）
| 变量 | 必填 | 描述 |
|---|---|---|
CALENDESK_API_KEY | 是 | 来自Calendesk管理面板的API密钥 |
CALENDESK_TENANT | 是 | 您的租户ID |
CALENDESK_GATEWAY_URL | 否 | 网关URL（默认为 https://mcp.calendesk.com) |
发展
- 克隆存储库：
git clone https://github.com/calendesk/calendesk-mcp-server.git
cd calendesk-mcp-server- 创建
.env文件：
cp .env.example .env
# Edit .env with your CALENDESK_API_KEY and CALENDESK_TENANT- 安装依赖项：
pip install -e .- 启动MCP检查器（需要Node.js）：
mcp dev calendesk_mcp/server.py:mcp在以下位置打开web UI http://localhost:6274 在那里，您可以交互式地测试工具。
隐私政策
支持
有关MCP服务器集成的问题，请通过以下方式联系我们： support@calendesk.com.