Cal.com Calendar

🚀 Cal.com日曆MCP服務器

Cal.com日曆MCP服務器集成了Cal.com日曆API，為用戶提供便捷的預約安排功能，可輕鬆管理各類日曆會議。

🚀 快速開始

若要使用Cal.com日曆MCP服務器，你需要先獲取API密鑰，再根據自身需求選擇合適的配置方式，最後完成服務器的構建。

✨ 主要特性

• 添加預約：可安排新的日曆會議，並能詳細記錄與會者的相關信息。
• 更新預約：能夠靈活修改現有預約的詳情，例如調整時間、添加或修改備註等。
• 刪除預約：可取消並移除不再需要的現有預約。
• 列出預約：支持查看特定日期範圍內已安排的所有預約。

📦 安裝指南

獲取API密鑰

1. 在Cal.com註冊一個新賬戶。
2. 進入設置 > 開發者 > API密鑰。
3. 生成一個新的API密鑰，並賦予適當的權限。

使用Claude Desktop配置

將以下內容添加到claude_desktop_config.json：

{
  "mcpServers": {
    "calcom-calendar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CALCOM_API_KEY",
        "mcp/calcom-calendar"
      ],
      "env": {
        "CALCOM_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

使用NPX配置

{
  "mcpServers": {
    "calcom-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-calcom-calendar"
      ],
      "env": {
        "CALCOM_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

構建

使用Docker構建：

docker build -t mcp/calcom-calendar:latest -f Dockerfile .

📚 詳細文檔

工具

calcom_add_appointment

• 功能：創建新的日曆會議。
• 輸入參數：
  • eventTypeId（數字）：Cal.com事件類型ID。
  • startTime（字符串）：開始時間，ISO格式（YYYY-MM-DDTHH:mm:ss.sssZ）。
  • endTime（字符串）：結束時間，ISO格式（YYYY-MM-DDTHH:mm:ss.sssZ）。
  • name（字符串）：與會者姓名。
  • email（字符串）：與會者郵箱。
  • notes（字符串，可選）：會議備註。

calcom_update_appointment

• 功能：更新現有日曆會議。
• 輸入參數：
  • bookingId（數字）：需要更新的Cal.com預定ID。
  • startTime（字符串，可選）：新的開始時間，ISO格式。
  • endTime（字符串，可選）：新的結束時間，ISO格式。
  • notes（字符串，可選）：新的備註。

calcom_delete_appointment

• 功能：刪除現有日曆會議。
• 輸入參數：
  • bookingId（數字）：需要刪除的Cal.com預定ID。
  • reason（字符串，可選）：刪除原因。

calcom_list_appointments

• 功能：列出日期範圍內的日曆預約。
• 輸入參數：
  • startDate（字符串）：開始日期，格式YYYY-MM-DD。
  • endDate（字符串）：結束日期，格式YYYY-MM-DD。

📄 許可證

此MCP服務器根據MIT License授權。這意味著您可以自由地使用、修改和分發軟件，但需遵守MIT License的條款和條件。有關詳細信息，請參閱項目倉庫中的LICENSE文件。