mcp-ical MCP 服务器

让您的 AI 助手连接日历：mcp-ical 赋能助手用简单自然语言管理事件、查询空闲和自动排程。

AI Calendar MCP Server Integration

“mcp-ical” MCP 服务器有什么作用？

mcp-ical MCP 服务器作为 AI 助手与您的 macOS 日历之间的桥梁，实现了无缝的自然语言日历管理交互。借助 Model Context Protocol (MCP)，mcp-ical 让用户可以通过对话查询日程、创建事件、更新约会并管理多个日历。这极大提升了生产力，将本需手动操作的日历事务转变为直观的 AI 自动化流程。凭借智能提醒、重复事件、自定义日历（包括通过 iCloud 集成的 Google 日历）等功能，mcp-ical 简化了日程安排、可用性检查和事件更新，是开发者和希望将日历管理集成到 AI 工作流或个人流程中的用户的得力工具。

提示词列表

仓库文档及代码中未明确列出提示词模板。

资源列表

文档未描述任何明确的 MCP 资源，文件中也未提供。

工具列表

事件创建：根据自然语言输入即时生成日历事件。
智能日程查询：依据用户查询获取即将到来的事件并检查可用时间。
事件更新：修改已有事件，包括时间、日期、日历、地点、备注、提醒和重复。
日历列表：查看全部可用日历并获得智能建议。

典型应用场景

自然语言日历管理： 用户可直接询问 AI 助手诸如“下周我有什么安排？”等问题，获得有序摘要，无需手动翻查日历应用。
自动化事件创建： 开发者可将服务器集成进工作流，实现会议、提醒、截止等事件的自动日程安排。
智能可用性查询： 快速查找会议或约会的空档时间，提升效率，减少沟通往返。
事件修改： 直接通过自然语言请求，轻松更新已有日历事件的细节，如改期、变更地点或添加备注等。
多日历及 Google 日历支持： 统一对话界面管理多个日历，包括通过 iCloud 同步的 Google 日历。

设置方法

Windsurf

前置要求：确保已安装 Node.js 和 Python 3.12+。
定位 Windsurf 配置文件（如 windsurf.config.json）。

在 mcpServers 区块中加入 mcp-ical MCP 服务器：

{
  "mcpServers": {
    "ical-mcp": {
      "command": "npx",
      "args": ["@mcp-ical/mcp-server@latest"]
    }
  }
}

保存配置并重启 Windsurf。
确认 MCP 集成中已出现该服务器。

API 密钥安全：

{
  "mcpServers": {
    "ical-mcp": {
      "command": "npx",
      "args": ["@mcp-ical/mcp-server@latest"],
      "env": {
        "ICAL_API_KEY": "${ICAL_API_KEY}"
      },
      "inputs": {
        "ICAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude

前置要求：Python 3.12+。
打开 Claude 集成配置文件。

插入如下 mcp-ical 配置：

{
  "mcpServers": {
    "ical-mcp": {
      "command": "npx",
      "args": ["@mcp-ical/mcp-server@latest"]
    }
  }
}

保存并重启 Claude。
验证日历连接。

Cursor

前置要求：确保已安装 Node.js 和 Python 3.12+。
定位 Cursor 配置文件。

添加 mcp-ical 服务器：

{
  "mcpServers": {
    "ical-mcp": {
      "command": "npx",
      "args": ["@mcp-ical/mcp-server@latest"]
    }
  }
}

保存并重启 Cursor。
确认服务器以 MCP 模式运行。

Cline

前置要求：安装 Node.js 和 Python 3.12+。
编辑 Cline 配置文件。

添加 mcp-ical 服务器配置：

{
  "mcpServers": {
    "ical-mcp": {
      "command": "npx",
      "args": ["@mcp-ical/mcp-server@latest"]
    }
  }
}

保存文件并重启 Cline。
通过简单日历指令进行测试。

注意： 请将 ICAL_API_KEY 及其他敏感值替换为环境变量以确保凭证安全。

在流程内使用该 MCP

FlowHunt 中使用 MCP

要将 MCP 服务器集成进 FlowHunt 工作流，首先添加 MCP 组件并与您的 AI 助手连接：

点击 MCP 组件打开配置面板。在 system MCP 配置区块，按如下 JSON 格式插入您的 MCP 服务器详情：

{
  "ical-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI 助手即可作为工具使用该 MCP，具备其全部功能。请记得将 “ical-mcp” 替换为实际 MCP 服务器名称，并更换为您自己的 MCP 服务器 URL。

总览

区块	可用性	详情/备注
总览	✅
提示词列表	⛔	未指定提示词模板
资源列表	⛔	未列出明确资源
工具列表	✅	文档中有日历工具说明
API 密钥安全	✅	提供了示例
采样支持（评测时不重要）	⛔	未说明