Astrocal

@astrocal/mcp-server

让你的 AI Agent 拥有安排会议的能力。Astrocal 的官方 Model Context Protocol 服务——这是一个 API 优先的日程安排平台，专为开发者和 AI Agent 打造。

兼容 Claude Desktop、Cursor、Windsurf 以及任何兼容 MCP 的客户端。你的 AI 助手可以通过自然对话查询空闲时间、预约会议、取消会议、改期和管理候补名单。

获取 API 密钥 | 文档 | API 参考

为什么 AI Agent 选择 Astrocal？

• 专为 AI 打造——不是 Calendly 的附加功能。Astrocal 的日程安排 API 从第一天起就旨在支持程序化访问和 AI Agent 访问。
• 8 个工具，零配置——查询空闲时间、预约、取消、改期、列出活动类型和管理候补名单。涵盖 Agent 所需的一切。
• 内置日历同步——可连接 Google Calendar、Microsoft 365 和 CalDAV。你的 Agent 会根据实际空闲时间安排会议。
• 支持付款——Stripe Connect 集成让你的 Agent 可以预约付费咨询，而不只是免费会议。
• 沙盒模式——使用 ac_test_* 密钥进行测试。不会发送邮件、创建日历事件或产生费用。

快速开始

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "astrocal": {
      "command": "npx",
      "args": ["-y", "@astrocal/mcp-server"],
      "env": {
        "ASTROCAL_API_KEY": "ac_live_xxxxxxxxxxxxx"
      }
    }
  }
}

重启 Claude Desktop，即可立即使用日程安排工具。

其他 MCP 客户端

全局安装：

npm install -g @astrocal/mcp-server

运行：

ASTROCAL_API_KEY=ac_live_xxx astrocal-mcp

环境变量

变量	必填	说明
ASTROCAL_API_KEY	是	你的 Astrocal API 密钥（免费获取）
ASTROCAL_API_URL	否	API 基础 URL（默认：https://api.astrocal.dev）
ASTROCAL_DEFAULT_EVENT_TYPE_ID	否	默认活动类型 ID——你的 Agent 无需在每次调用时指定

可用工具

check_availability

查询可预约的时间段。

• event_type_id（string，可选）— 要查询的活动类型。如果已设置 ASTROCAL_DEFAULT_EVENT_TYPE_ID，则可省略。
• start_date（string，必填）— ISO 8601 格式的开始日期（例如，2026-03-15）
• end_date（string，必填）— ISO 8601 格式的结束日期（例如，2026-03-22）
• timezone（string，可选）— IANA 时区（例如，America/New_York）。默认为 UTC。

create_booking

在指定时间预约会议。

• event_type_id（string，可选）— 要预约的活动类型。已设置默认值时可省略。
• start_time（string，必填）— ISO 8601 日期时间（例如，2026-03-15T14:00:00Z）
• invitee_name（string，必填）— 预约者的全名
• invitee_email（string，必填）— 用于接收日历邀请的电子邮件地址
• invitee_timezone（string，可选）— IANA 时区。默认为 UTC。
• notes（string，可选）— 会议备注（最多 1000 个字符）

cancel_booking

取消现有预约。系统会自动向预约者发送取消邮件。

• booking_id（string，必填）— 要取消的预约 ID
• reason（string，可选）— 取消原因（最多 500 个字符）

reschedule_booking

将预约改到新时间。请先查询空闲时间。

• booking_id（string，必填）— 要改期的预约 ID
• new_start_time（string，必填）— ISO 8601 格式的新时间
• reason（string，可选）— 改期原因（最多 500 个字符）

list_bookings

列出预订，可使用可选筛选条件。

• status（字符串，可选）— 筛选：confirmed、cancelled 或 pending_payment
• limit（数字，可选）— 最大结果数（默认值：10，最大值：100）
• event_type_id（字符串，可选）— 按活动类型筛选

list_event_types

列出可供预订的活动类型。无需输入。

join_waitlist

所有时段都已满时，加入候补名单。

• event_type_id（字符串，必填）— 要加入候补名单的活动类型
• name（字符串，必填）— 全名
• email（字符串，必填）— 电子邮件地址
• preferred_times（字符串，可选）— 首选时间段或备注

check_waitlist

查看你在候补名单中的位置。

• waitlist_entry_id（字符串，必填）— join_waitlist 返回的候补名单条目 ID

对话示例

用户：“我可以预订哪些会议？”

Agent：调用 list_event_types — “你有两种活动类型：30 分钟咨询（免费）和 1 小时策略会议（50 美元）。”

用户：“查看下周二下午 2 点是否有咨询时段”

Agent：调用 check_availability —“下周二下午 2 点有空。”

用户：“帮我用 [email protected] 预订”

Agent：调用 create_booking —“完成！已为 Jane 确认 3 月 17 日星期二 UTC 时间下午 2:00 的会议。日历邀请已发送。”

用户：“等等，改到下午 3 点”

Agent：调用 reschedule_booking —“已改期至下午 3:00。Jane 已收到通知。”

Astrocal 平台的一部分

这个 MCP 服务是与 Astrocal 集成的多种方式之一：

• REST API — 完整的日程安排 API，附带 OpenAPI 3.1 规范
• React SDK（@astrocal/react）— 为 React 应用提供类型化钩子、Provider 和预订组件
• 可嵌入组件（@astrocal/widget）— 可添加到任何网站的即用型预订界面
• 仪表板 — 管理活动类型、预订、团队成员和账单
• Webhooks — 实时接收预订事件通知

创建免费账户即可开始使用。

链接

• Astrocal 网站
• 文档
• API 参考
• 仪表板
• GitHub
• 问题反馈

许可证

MIT