Calendesk

Calendesk MCP Server

将 Calendesk 预约平台连接到 Claude、Claude Desktop、Claude Code 及其他兼容 MCP 的 AI 工具。通过自然语言管理预约、客户、员工、服务并查看业务分析数据——所有操作均可完成。提供 32 个工具，支持 OAuth 登录，数据不会离开你的 Calendesk 账户。

前提条件

• 一个 Calendesk 账户

设置

Claude.ai（推荐）

无需安装或 API 密钥。使用 OAuth 进行安全身份验证。

1. 在 Claude.ai 中前往设置 → 连接器
2. 点击添加自定义连接器
3. 输入：
   • 名称： Calendesk
   • 远程 MCP 服务 URL： https://claude.calendesk.com
4. 点击添加
5. 按提示使用 Calendesk 凭据登录（OAuth——无需复制 API 密钥）

Claude Desktop

将以下内容添加到配置文件中（macOS/Linux 上为 ~/.config/claude/claude_desktop_config.json，Windows 上为 %APPDATA%\Claude\claude_desktop_config.json）：

{
    "mcpServers": {
        "calendesk": {
            "url": "https://mcp.calendesk.com",
            "headers": {
                "X-Api-Key": "your-api-key",
                "X-Tenant": "your-tenant-id"
            }
        }
    }
}

在管理面板 → 设置 → API中生成 API 密钥。

Claude Code

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_events - 列出日历活动（预约、封锁/休假、团体预约），并可使用筛选条件
• get_booking - 按 ID 获取指定预约的详细信息
• create_booking - 创建新的预约/约会
• update_booking - 更新现有预约
• delete_booking - 删除预约
• get_group_booking - 获取团体预约的详细信息
• check_event_overlaps - 检查日程冲突
• get_unavailable_slot - 获取封锁/休假时段的详细信息
• create_unavailable_slot - 为员工创建封锁/休假时段
• update_unavailable_slot - 更新封锁/休假时段
• delete_unavailable_slot - 删除封锁/休假时段

客户

• 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 - 获取所有可用标签

分析与统计

• get_stats - 业务分析：仪表板关键绩效指标、收入、预约、员工绩效、服务、客户、模式、付款、订阅、地点、产品和预测。使用 type 参数选择报告。

设置与通知

• get_settings - 获取业务设置（时区、货币、公司信息）
• get_me - 获取当前用户个人资料和员工信息
• send_notification - 发送电子邮件、短信或推送通知

权限和访问

访问权限与你在 Calendesk 中的角色和权限一致——连接器只能执行你自己的 Calendesk 用户在管理面板中能执行的操作。员工连接自己的帐户后，看到的内容与登录时完全相同，不会看到更多内容。

• 读取工具（列表、查看、搜索、分析）无需额外确认即可运行。
• 写入工具（创建／更新／删除预订、客户和时段；发送通知）会标记为具有破坏性，因此 Claude 会在每次操作前征求你的确认。

如果你的电子邮件地址关联了多家 Calendesk 公司，你可以在登录时选择要连接的公司。每次工具调用都限定在该单一租户内。

数据处理和安全

• 仅使用第一方服务。 每次工具调用都会通过 HTTPS 发送至 Calendesk 自有的 API。不会涉及第三方服务，也不会出售或共享任何数据。
• 仅处理你的帐户数据。 服务端会在你的 Calendesk 帐户中读取和写入预订、客户、员工、服务、设置和分析数据。绝不会触及租户之外的数据。
• 使用 OAuth，不使用共享密钥。 Claude.ai 使用 OAuth 2.1（授权码 + PKCE，并采用动态客户端注册）进行连接。访问令牌和刷新令牌由 Calendesk 签发，仅用于代表你调用 Calendesk API。可自托管的设置使用你自行生成的 API 密钥和租户 ID。
• 不存储对话。 服务端处理每次工具调用并返回结果。它不会存储、记录或转发你的对话、聊天记录或消息。
• 由你掌控。 你可以随时在 Claude.ai 设置 → 连接器中断开连接器，或在 Calendesk 管理面板中撤销 API 密钥。

数据收集和保留方式详见 Calendesk 隐私政策。

示例

查看今天的日程安排

你：“我今天的日程安排是什么样的？”

助手使用今天的日期调用 list_events，并返回：

你今天有 4 个预约：

时间	服务	客户	状态
09:00–10:00	理发	Maria Kowalska	已批准
10:30–11:30	染发	Anna Wiśniewska	已批准
13:00–14:00	理发	Jan Nowak	已批准
15:00–16:00	修胡子	Tomasz Zieliński	已批准

查找可预约时段并预约

你：“下周什么时候可以预约 Kowalski 医生进行 60 分钟的咨询？”

助手针对该服务和员工调用 get_available_slots，然后回复：

Kowalski 医生下周有以下空档：

**周一：**09:00、11:00、14:00 **周二：**10:00、13:00、15:00 **周四：**09:00、11:00

你想预约其中一个时段吗？

你：“预约周一 11:00，客户是 [email protected]”

助手调用 search_users 查找客户，然后调用 check_event_overlaps 确认没有时间冲突，最后调用 create_booking：

预约已确认：

• **服务：**咨询（60 分钟）
• **员工：**Kowalski 医生
• **客户：**Anna Wiśniewska（[email protected]）
• **时间：**3 月 17 日（周一）11:00–12:00
• 预约 ID：#4521

查看业务表现

你：“上个月的业务表现与再前一个月相比如何？”

助手使用日期范围调用 get_stats（仪表板报告）：

2026 年 2 月对比 2026 年 1 月：

指标	2 月	变化
营收	€12 500	+8.5%
预订数	285	+12
新客户数	18	+5
取消率	3.5%	−0.8pp

营收呈上升趋势，主要得益于染发预订量增加了 +22%。

搜索客户

你：“帮我查找姓 Kowalska 的客户的联系信息”

助手调用 search_users：

找到 2 个匹配项：

1. Maria Kowalska — [email protected]，+48 512 345 678（上次到访：3 月 5 日）
2. Ewa Kowalska — [email protected]，+48 601 234 567（上次到访：2 月 12 日）

发送通知

你：“给 Maria Kowalska 发送一封电子邮件，提醒她明天有预约”

助手调用 send_notification：

已向 Maria Kowalska（[email protected]）发送电子邮件，提醒她明天 09:00 有理发预约。

环境变量（仅限 STDIO 模式）

变量	必需	描述
CALENDESK_API_KEY	是	Calendesk 管理面板中的 API 密钥
CALENDESK_TENANT	是	你的租户 ID
CALENDESK_GATEWAY_URL	否	网关 URL（默认为 https://mcp.calendesk.com）

开发

1. 克隆代码库：

   git clone https://github.com/calendesk/calendesk-mcp-server.git
   cd calendesk-mcp-server
   

2. 创建 .env 文件：

   cp .env.example .env
   # Edit .env with your CALENDESK_API_KEY and CALENDESK_TENANT
   

3. 安装依赖项：

   pip install -e .
   

4. 启动 MCP Inspector（需要 Node.js）：

   mcp dev calendesk_mcp/server.py:mcp
   

   在 http://localhost:6274 打开一个 Web 界面，你可以在其中交互式测试工具。

隐私政策

Calendesk 隐私政策

支持

如对 MCP 服务集成有疑问或遇到问题，请通过 [email protected] 联系我们。