Savvycal Mcp Server

SavvyCal MCP 服务

一个将 Claude 连接到你的 SavvyCal 账户的 MCP（Model Context Protocol）服务。你可以用自然语言询问 Claude 即将举行的会议、查看空闲时间、预订会议并管理日程安排链接。

你可以做什么

• “我这周有哪些会议？” — 列出即将举行的预订，并显示与会者详情和加入链接
• “我下周什么时候有空进行 30 分钟的通话？” — 检查任意日程安排链接的可用时段
• “在周二下午 2 点预订一场与 [email protected] 的会议” — 直接创建预订
• “取消我今天下午 3 点的会议” — 取消已安排的活动
• “我度假期间关闭我的介绍通话链接” — 暂停或恢复日程安排链接
• “显示我所有的预订类型” — 列出你所有的日程安排链接及其状态和时长

工具

工具	描述
savvycal_list_events	列出即将举行和过去的会议，支持日期筛选和分页
savvycal_get_event	获取指定活动的完整详情，包括加入链接
savvycal_cancel_event	取消已安排的会议
savvycal_create_event	在日程安排链接上预订会议
savvycal_list_scheduling_links	列出你所有的日程安排链接
savvycal_get_available_slots	获取日程安排链接的可用时段
savvycal_toggle_link	启用或禁用日程安排链接
savvycal_get_current_user	获取你的账户信息和时区

设置

1. 获取 SavvyCal API 密钥

1. 登录 SavvyCal
2. 前往 设置 → 开发者设置
3. 点击 创建令牌 并为其命名（例如“Claude MCP”）
4. 复制令牌——下一步需要用到

2. 配置 Claude Code（stdio，本地使用）

将以下内容添加到项目根目录中的 .mcp.json：

{
  "mcpServers": {
    "savvycal": {
      "command": "npx",
      "args": ["savvycal-mcp-server"],
      "env": {
        "SAVVYCAL_API_KEY": "pt_secret_your_token_here"
      }
    }
  }
}

或者直接运行：

SAVVYCAL_API_KEY=pt_secret_your_token_here npx savvycal-mcp-server

3. 配置 HTTP（远程／托管部署）

SAVVYCAL_API_KEY=pt_secret_your_token_here TRANSPORT=http PORT=3000 node dist/index.js

服务提供：

• POST /mcp — MCP 端点
• GET /health — 健康检查

开发

# Clone and install
git clone https://github.com/your-username/savvycal-mcp-server
cd savvycal-mcp-server
npm install

# Set your API key
export SAVVYCAL_API_KEY=pt_secret_your_token_here

# Build
npm run build

# Run (stdio)
npm start

# Run (HTTP)
TRANSPORT=http npm start

环境变量

变量	必需	默认值	描述
SAVVYCAL_API_KEY	✅ 是	—	你的 SavvyCal 个人访问令牌
TRANSPORT	否	stdio	传输模式：stdio 或 http
PORT	否	3000	HTTP 传输使用的端口

对话示例

查看日程：

“我明天有哪些会议？” “显示我本月的所有预订” “最近有人取消会议吗？”

查看空闲时间：

“我下周什么时候有空进行 30 分钟的介绍通话？” “我的咨询链接周五有哪些可用时段？”

预订会议：

“下周一上午 10 点为我和 Sarah（[email protected]）预订一场 30 分钟的介绍通话”

管理链接：

“暂停我的所有日程安排链接——我要去度假” “重新启用我的介绍通话链接” “我有多少个启用中的日程安排链接？”

许可证

MIT