日历数据访问服务

提供对Outlook/Office 365日历数据的只读访问服务,支持事件列表查询、单事件获取、事件搜索和今日议程获取。

  • by dmarkey
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 dmarkey/mcp-ical

使用说明

mcp临床

MCP服务器,用于只读访问Outlook/Office 365 iCal日历源。建于 FastMCP.

工具

工具 说明
list_events 列出时间窗口内的事件(可配置提前/推迟天数)
get_event 按UID获取单个事件
search_events 按摘要、描述或位置中的文本搜索事件
todays_agenda 获取今天的所有活动

每个事件包括:摘要、开始/结束时间、位置、描述、UID、状态、组织者和与会者(在提要中可用时)。

设置

需要Python 3.13+和 紫外线.

uv sync

配置

设置 ICAL_URL Outlook发布的iCal URL的环境变量:

https://outlook.office365.com/owa/calendar/<id>@<domain>/<path>/reachcalendar.ics

您可以从Outlook获取此URL: 设置>日历>共享日历>发布日历.

跑步

ICAL_URL="https://..." uv run mcp-ical

或者通过FastMCP CLI:

ICAL_URL="https://..." uv run fastmcp run mcp_ical/server.py:mcp

Claude代码集成

增添 ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-ical", "mcp-ical"],
      "env": {
        "ICAL_URL": "https://outlook.office365.com/owa/calendar/..."
      }
    }
  }
}

备注

  • 此服务器是 只读 --它获取并解析iCal提要,但无法修改您的日历。
  • Outlook发布的iCal提要通常会删除ORGANIZER和ATTENDEE字段以保护隐私。与会者信息只能出现在活动描述文本中。