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 引用环境变量名的字段。

后端特定注意事项

谷歌日历设置（一次性）

1. Google 云控制台 → 创建项目→ 启用 谷歌日历API
2. 创建 OAuth2凭据 （桌面应用程序）→ 下载 credentials.json
3. 地点为 google_calendar_credentials.json 在您的配置目录中
4. 运行身份验证流：

   python -m renfield_mcp_calendar --auth google --calendar family

1. 完成基于浏览器的授权——令牌会自动保存

MCP工具

示例查询（通过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

许可证

麻省理工学院