AI导哈

日历统一访问服务

通过单一接口统一访问Exchange、Google Calendar和CalDAV日历的服务，支持多日历配置和跨日历合并查询。

  • by ebongard
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ebongard/renfield-mcp-calendar

使用说明

伦菲尔德mcp日历

用于日历访问的统一MCP服务器--连接 交易所（EWS）, 谷歌日历，以及 CalDAV （Nextcloud、ownCloud、Radical）通过单一 模型上下文协议 界面。

特性

  • 多日历 --通过YAML配置多个日历帐户，单独或一次性查询它们
  • 跨日历合并 — list_events 如果没有日历参数，则返回按时间顺序排序的所有日历中的事件
  • 三个后端 -Exchange Web服务（EWS）、Google日历API、CalDAV
  • 配置中没有密码 --通过环境变量名引用的凭据
  • 延迟连接 --后端客户端在首次使用时初始化，而不是在启动时初始化
  • 异步就绪 --所有阻塞I/O都用 asyncio.run_in_executor
  • 谷歌OAuth2助手 --内置 --auth google CLI用于初始令牌设置

安装

pip install renfield-mcp-calendar

或者直接从GitHub：

pip install "renfield-mcp-calendar @ https://github.com/ebongard/renfield-mcp-calendar/archive/refs/heads/main.tar.gz"

配置

集 CALENDAR_CONFIG 指向您的YAML配置文件（默认值： /config/calendar_accounts.yaml).

示例 calendar_accounts.yaml

calendars:
  # Exchange 2019 (on-premise, direct EWS endpoint)
  - name: work
    label: "Work Calendar"
    type: ews
    ews_url: "https://exchange.example.com/EWS/Exchange.asmx"
    username_env: CALENDAR_WORK_USERNAME
    password_env: CALENDAR_WORK_PASSWORD

  # Google Calendar (OAuth2 Desktop Flow)
  - name: family
    label: "Family Calendar"
    type: google
    calendar_id: "primary"
    credentials_file: "/config/google_calendar_credentials.json"
    token_file: "/data/google_calendar_token.json"

  # Nextcloud / CalDAV
  - name: club
    label: "Club Calendar"
    type: caldav
    url: "https://nextcloud.example.com/remote.php/dav/calendars/user/club/"
    username_env: CALENDAR_CLUB_USERNAME
    password_env: CALENDAR_CLUB_PASSWORD

安全： 密码和令牌是 从不 存储在YAML文件中--使用 *_env 引用环境变量名的字段。

后端特定注意事项

后端 库 身份验证 注释
早期预警系统 交换库 NTLM/基本 直接EWS URL，无需自动发现
谷歌 googleapi-python客户端 OAuth2桌面流 令牌自动刷新，一次性浏览器身份验证
CalDAV 卡尔达夫 基本授权 适用于Nextcloud、ownCloud、Radical等。

谷歌日历设置（一次性）

  1. Google 云控制台 → 创建项目→ 启用 谷歌日历API
  2. 创建 OAuth2凭据 （桌面应用程序）→ 下载 credentials.json
  3. 地点为 google_calendar_credentials.json 在您的配置目录中
  4. 运行身份验证流：
    python -m renfield_mcp_calendar --auth google --calendar family
  5. 完成基于浏览器的授权——令牌会自动保存

MCP工具

工具 参数 说明
list_calendars -- 列出所有已配置的日历帐户
list_events calendar?, start, end 一个或所有日历中的事件。空 calendar =从所有中合并。
create_event calendar, title, start, end, description?, location? 创建新事件
update_event calendar, event_id, title?, start?, end?, ... 更新事件的特定字段
delete_event calendar, event_id 删除事件
get_event calendar, event_id 获取一个包含完整细节的单一活动

示例查询（通过LLM）

  • “今天怎么样？” → list_events() （所有日历，今天）
  • “本周公司日历上有什么？” → list_events(calendar="work", start="...", end="...")
  • “明天下午2点做一个家庭约会：牙医” → create_event(calendar="family", ...)
  • “明天下午我有空吗？” → list_events(start="...", end="...")

用法

# Run as MCP server (stdio transport)
python -m renfield_mcp_calendar

# Or via entry point
renfield-mcp-calendar

# Google OAuth2 setup (one-time)
python -m renfield_mcp_calendar --auth google --calendar family

克劳德桌面/MCP客户端配置

{
  "mcpServers": {
    "calendar": {
      "command": "python",
      "args": ["-m", "renfield_mcp_calendar"],
      "env": {
        "CALENDAR_CONFIG": "/path/to/calendar_accounts.yaml",
        "CALENDAR_WORK_USERNAME": "user@example.com",
        "CALENDAR_WORK_PASSWORD": "secret"
      }
    }
  }
}

发展

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests (29 tests)
pytest tests/ -v

许可证

麻省理工学院

相关 MCP