mcpField
C
calendarport

calendarport

本地服务
github.com/CloudCorpRecords生产力02 周前更新
代码仓库

关于 calendarport

calendarport 将 Google Calendar 日历、事件和空闲忙碌查询封装为工具，供需要日历操作的 Agent 使用。它通过 Google Calendar API 提供核心日历与事件操作。

主要功能

  1. 01列出并获取日历
  2. 02创建日历和事件
  3. 03查询、更新及删除事件
  4. 04快速添加事件
  5. 05检查空闲忙碌时段

适用场景

  1. 01查询指定时间范围内的日历事件
  2. 02创建或修改日历事件
  3. 03检查参与者是否有空

MCP 相关

MCP 服务向客户端提供 10 个 Google Calendar 工具，用于管理日历和事件、快速添加事件及检查空闲忙碌情况。调用需要配置 Google OAuth 访问令牌。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-calendarport": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/calendarport"
      ]
    }
  }
}
启动命令npx -y @reneturcios/calendarport

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/calendarport0.1.0
ocighcr.io/cloudcorprecords/calendarport:0.1.0

工具

10

收录的工具列表 · 更新于 1 周前

此工具无需参数。

详细介绍

calendarport

将 Google Calendar 日历和事件作为 MCP 工具，并与 Google Calendar API 通信。calendarport 是对 Google Calendar 参考 MCP 服务核心功能的 全新实现，采用新名称：根据公开的 Calendar API 文档编写全新代码，不 复制品牌元素。

工具（核心子集，共 10 个）

list_calendars、get_calendar、create_calendar、list_events、 get_event、create_event、update_event、delete_event、 quick_add_event、check_free_busy。

更广泛的 Calendar 功能中的日历 ACL 和规则、事件移动／导入／实例／监控、附件、 会议数据、设置和颜色均不在此子集中。事件工具中的 calendar_id 为可选项， 默认值为 primary。

设置

设置 Google OAuth 访问令牌：

export GOOGLE_ACCESS_TOKEN=ya29....

也可以通过 CALENDAR_API_URL 覆盖 API 基础 URL （默认值为 https://www.googleapis.com/calendar/v3）。如果未设置令牌， 每次工具调用都会失败，并指出缺少的变量。

CLI

npx @reneturcios/calendarport list_events '{"time_min":"2026-10-27T00:00:00Z"}'
npx @reneturcios/calendarport mcp        # stdio MCP server

每个工具名称都是一个子命令，接受一个 JSON 对象参数。

MCP 客户端配置

{
  "mcpServers": {
    "calendarport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/calendarport", "mcp"],
      "env": { "GOOGLE_ACCESS_TOKEN": "ya29...." }
    }
  }
}

Docker

docker run -i -e GOOGLE_ACCESS_TOKEN ghcr.io/cloudcorprecords/calendarport

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。