Calendly MCP Server

一个用于与Calendly API集成的模型上下文协议（MCP）服务器。此服务器提供了与Calendly调度平台交互的工具，允许您检索用户信息、列出事件、管理受邀者、取消事件，并通过新的调度API直接安排会议。

功能

核心Calendly集成

• 用户信息：获取当前认证用户的详细信息
• 事件管理：列出、检索和取消已安排的事件
• 受邀者管理：列出并管理事件的受邀者
• 组织：列出组织成员资格

新功能：调度API集成

• 直接会议安排：无需重定向即可通过编程方式预订会议
• 事件类型发现：列出可用于调度的可用事件类型
• 实时可用性：检查任何事件类型的可用时间槽
• 完整的预订流程：从头到尾的调度，包括日历同步和通知
• 地点支持：Zoom、Google Meet、Teams、物理位置和自定义选项

安装

方案1：NPX（推荐）

无需安装直接运行：

npx calendly-mcp-server

方案2：手动安装

1. 克隆此仓库：

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

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

配置

认证

此服务器支持两种认证方法：

方案1：个人访问令牌（PAT）

适用于内部应用或个人使用：

1. 从您的Calendly集成页面获取个人访问令牌
2. 选择API和Webhook → 现在获取令牌
3. 设置环境变量：

export CALENDLY_API_KEY="your_personal_access_token_here"

方案2：OAuth 2.0

适用于多个用户使用的公共应用：

1. 在developer.calendly.com创建开发者账户
2. 创建OAuth应用以获取客户端凭证
3. 设置环境变量：

export CALENDLY_CLIENT_ID="your_client_id_here"
export CALENDLY_CLIENT_SECRET="your_client_secret_here"

4. 可选地，如果您已有令牌：

export CALENDLY_ACCESS_TOKEN="your_access_token_here"
export CA
CALENDLY_REFRESH_TOKEN="your_refresh_token_here"

可选用户上下文（推荐）

为了更好的性能和自动默认设置，您可以设置特定用户的URI：

export CALENDLY_USER_URI="https://api.calendly.com/users/your_user_id"
export CALENDLY_ORGANIZATION_URI="https://api.calendly.com/organizations/your_org_id"

这些可以在认证后通过运行get_current_user来获得。设置后，服务器将自动使用这些作为需要用户上下文的API调用的默认值。

MCP配置

将服务器添加到您的MCP客户端配置中（例如，Claude Desktop）：

方案1：使用NPX（推荐）

对于个人访问令牌：

{
  "mcpServers": {
    "calendly": {
      "command": "npx",
      "args": ["calendly-mcp-server"],
      "env": {
        "CALENDLY_API_KEY": "your_personal_access_token_here",
        "CALENDLY_USER_URI": "https://api.calendly.com/users/your_user_id",
        "CALENDLY_ORGANIZATION_URI": "https://api.calendly.com/organizations/your_org_id"
      }
    }
  }
}

对于OAuth 2.0：

{
  "mcpServers": {
    "calendly": {
      "command": "npx",
      "args": ["calendly-mcp-server"],
      "env": {
        "CALENDLY_CLIENT_ID": "your_client_id_here",
       

由于篇幅限制，这里只展示了部分内容的翻译。如需完整翻译，请告知我继续进行。