AI导哈

Calendesk MCP 服务器

连接Calendesk预订平台与MCP兼容的AI工具，通过自然语言管理预订、客户、员工、服务和业务分析。

  • by Calendesk
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Calendesk/calendesk-mcp-server

使用说明

Calendesk MCP服务器

连接您的 日历 Claude、Claude Desktop、Claude Code和其他兼容MCP的人工智能工具的预订平台。通过自然语言管理预订、客户、员工、服务和查看业务分析。32个工具，OAuth登录，没有数据离开你的Calendesk帐户。

先决条件

设置

第ai条（推荐）

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

  1. 首选 设置→ 连接器 在Claude.ai
  2. 点击 添加自定义连接器
  3. 输入：
    • 姓名： 日历
    • 远程MCP服务器URL: https://claude.calendesk.com
  4. 点击 加
  5. 提示时使用您的Calendesk凭据登录（OAuth-没有要复制的API密钥）

克劳德桌面版

添加到配置文件(~/.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 代码

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 -业务分析：仪表板KPI、收入、预订、员工绩效、服务、客户、模式、支付、订阅、位置、产品、预测。使用 type 用于选择报告的参数。

设置和通知

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

权限和访问

Access反映了您的Calendesk角色和权限——连接器只能执行您自己的Calendesk-用户在管理面板中可以执行的操作。连接帐户的员工只会看到登录时看到的内容，仅此而已。

  • 阅读工具 （列出、查看、搜索、分析）无需额外提示即可运行。
  • 编写工具 （创建/更新/删除预订、客户和区块；发送通知）被标记为破坏性的，因此克劳德在每次之前都会要求您确认。

如果您的电子邮件属于多个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 理发 玛丽亚·科瓦尔斯基 已批准
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_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日）
  2. 伊娃 科瓦尔斯卡 — 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)

发展

  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检查器（需要Node.js）：

    mcp dev calendesk_mcp/server.py:mcp

    在以下位置打开web UI http://localhost:6274 在那里，您可以交互式地测试工具。

隐私政策

Calendesk隐私政策

支持

有关MCP服务器集成的问题，请通过以下方式联系我们： support@calendesk.com.

相关 MCP