PolarHub
  • Agents
  • MCP Servers
  • Skills
  • PolarBear
PolarHub © 2026
MCP Serverscalendar-managementfalgom4
返回「calendar-management」

falgom4

modelscope·@falgom4/calendar-mcp

calendar-management0下载LocalModelScope

简介

暂无描述。

MCP Server 详情

来自 ModelScope 索引

Google 日历自动认证 MCP 服务器

smithery 徽章

这是一个用于 Claude 桌面版与 Google 日历集成的 Model Context Protocol (MCP) 服务器,支持自动认证。该服务器使 AI 助手能够通过自然语言交互来管理 Google 日历。

![](https://badge.mcpx.dev?type=server MCP 服务器 )

功能

  • 创建带有标题、描述、地点和参与者的日历事件
  • 更新现有的日历事件
  • 删除日历事件
  • 获取事件详情
  • 列出指定时间范围内的事件
  • 通过关键词搜索事件
  • 列出所有可用的日历
  • 支持自然语言日期/时间输入(例如,“明天下午2点”,“下周一”)
  • 完全集成 Google 日历 API
  • 简单的 OAuth2 认证流程,并自动启动浏览器
  • 同时支持桌面应用和 Web 应用的凭证
  • 全局凭证存储以方便使用

安装与认证

通过 Smithery 安装

要通过 Smithery 自动安装适用于 Claude 桌面版的 Google 日历集成服务器,请执行以下命令:

bash npx -y @smithery/cli install @falgom4/calendar-mcp --client claude

手动安装

  1. 创建一个 Google Cloud 项目并获取凭证:

    a. 创建 Google Cloud 项目:

    • 前往 Google Cloud 控制台
    • 创建新项目或选择现有项目
    • 为您的项目启用 Google 日历 API

    b. 创建 OAuth 2.0 凭证:

    • 转到 "APIs & Services" > "Credentials"
    • 点击 "Create Credentials" > "OAuth client ID"
    • 选择 "Desktop app" 或 "Web application" 作为应用程序类型
    • 给它命名并点击 "Create"
    • 对于 Web 应用程序,将 http://localhost:3000/oauth2callback 添加到授权重定向 URI 中
    • 下载客户端的 OAuth 密钥 JSON 文件
    • 将密钥文件重命名为 gcp-oauth.keys.json
  2. 运行认证:

    您可以通过两种方式进行认证:

    a. 全局认证(推荐): bash

    首次:将 gcp-oauth.keys.json 放在您主目录下的 .calendar-mcp 文件夹中

    mkdir -p ~/.calendar-mcp mv gcp-oauth.keys.json ~/.calendar-mcp/

    从任何地方运行认证

    npx @nchufa/calendar auth

    b. 本地认证: bash

    将 gcp-oauth.keys.json 放在当前目录中

    该文件将被自动复制到全局配置

    npx @nchufa/calendar auth

    认证过程将:

    • 在当前目录或 ~/.calendar-mcp/ 中查找 gcp-oauth.keys.json
    • 如果在当前目录找到,则将其复制到 ~/.calendar-mcp/
    • 打开默认浏览器进行 Google 认证
    • 将凭证保存为 ~/.calendar-mcp/credentials.json

    注意:

    • 成功认证后,凭证将全局存储在 ~/.calendar-mcp/ 中,可以从任何目录使用
    • 同时支持桌面应用和 Web 应用程序的凭证
    • 对于 Web 应用程序凭证,请确保将 http://localhost:3000/oauth2callback 添加到您的授权重定向 URI 中
  3. 在 Claude 桌面版中配置:

将以下内容添加到您的 Claude 桌面版配置文件中:

json { "mcpServers": { "calendar": { "command": "npx", "args": [ "@nchufa/calendar" ] } } }

可用工具

服务器提供了以下可通过 Claude 桌面版使用的工具:

1. 创建事件 (create_event)

创建一个新的日历事件。

json { "summary": "团队会议", "description": "每周团队同步讨论项目进展", "location": "会议室 A", "start": "2025-04-01T14:00:00", "end": "2025-04-01T15:00:00", "attendees": ["colleague@example.com", "manager@example.com"], "reminders": { "useDefault": false, "overrides": [ { "method": "email", "minutes": 30 }, { "method": "popup", "minutes": 10 } ] } }自然语言日期/时间也受支持:

json { "summary": "与John喝咖啡", "location": "市中心星巴克", "start": "明天下午2:30", "end": "明天下午3:30" }

2. 获取事件 (get_event)

检索特定日历事件的详细信息。

json { "eventId": "abc123xyz456", "calendarId": "primary" }

3. 更新事件 (update_event)

更新现有的日历事件。

json { "eventId": "abc123xyz456", "summary": "更新后的会议标题", "location": "新地点", "start": "2025-04-01T15:00:00", "end": "2025-04-01T16:00:00" }

4. 删除事件 (delete_event)

删除一个日历事件。

json { "eventId": "abc123xyz456", "calendarId": "primary" }

5. 列出事件 (list_events)

列出指定时间范围内的日历事件。

json { "calendarId": "primary", "timeMin": "2025-04-01T00:00:00", "timeMax": "2025-04-07T23:59:59", "maxResults": 10, "orderBy": "startTime" }

6. 搜索事件 (search_events)

搜索与查询匹配的事件。

json { "query": "会议", "calendarId": "primary", "timeMin": "2025-04-01T00:00:00", "maxResults": 5 }

7. 列出日历 (list_calendars)

列出所有可用的日历。

json {}

自然语言日期/时间支持

服务器支持多种自然语言格式的日期和时间:

  • 特定日期:"2025-04-01T14:00:00"(ISO格式)
  • 简单引用:"今天"、"明天"、"现在"
  • 相对时间:"2小时后"、"3天后"
  • 星期引用:"下周一"、"下周二"
  • 组合格式:"明天下午2点"、"周一15:30"

这使得使用自然语言指令创建和更新事件变得非常容易。

安全注意事项

  • OAuth凭据安全地存储在您的本地环境(~/.calendar-mcp/)中
  • 服务器使用离线访问来保持持久认证
  • 请勿共享或提交您的凭据到版本控制系统
  • 定期审查并在Google帐户设置中撤销未使用的访问权限

故障排除

  1. 找不到OAuth密钥

    • 确保gcp-oauth.keys.json位于当前目录或~/.calendar-mcp/中
    • 检查文件权限
  2. 无效的凭据格式

    • 确保证书文件包含web或installed凭据
    • 对于Web应用程序,请验证重定向URI是否正确配置
  3. 端口已被占用

    • 如果端口3000已被占用,请在运行身份验证之前释放该端口
    • 您可以找到并停止使用该端口的进程

贡献

欢迎贡献!请随时提交Pull Request。

许可证

MIT

致谢

特别感谢GongRzhe及其Calendar-Autoauth-MCP-Server项目,该项目为本实现奠定了基础。

支持

如果您遇到任何问题或有疑问,请在GitHub仓库上提交一个问题。

相关 MCP Servers(来自「calendar-management」)

飞常准-Aviation

VariFlight航班信息服务的模型上下文协议(MCP)服务器实现方案。该服务器提供了多种工具,支持查询航班信息、天气数据及航班舒适度指标。

@variflight-ai/variflight-mcp

快递100 MCP Server

快递100 MCP Server提供快递信息查询、快递运费预估比价、快递时效查询(含发货前时效查询与在途动态时效查询)等功能。

kuaidi100/kuaidi100-mcp

全球实时时间查询(MCP&Agent挑战赛)

实时时间获取函数,可根据指定时区获取当前时间(默认中国时间),并以格式化文本返回详尽的时间信息。 可获取的详尽时间信息包括:时区、时区缩写、当前时间、星期、日期、具体时间、年份、月份、日期、小时、分钟、秒钟、 一年中的第几天、一年中的第几周、是否为夏令时、客户端IP、与UTC的偏移、与UTC的时差描述等。

JackGan/realtime

UU跑腿MCP

现已支持5个核心API接口和MCP协议的对接, 涵盖询价、发单、查询详情等,是国内首家兼容MCP协议的配送服务商。

@uupt-mcp/uupt-mcp-server

全球机票查询-RollingGo

RollingGo-Flight-MCP 是一款 MCP 原生的全球机票服务插件,完美适配 Claude 、Cursor、Codex等AI Agent 和主流 MCP 客户端。 基于道旅官方供应链,内置机场智能识别与航班多维检索两大核心工具,整合 RollingGo 全球 500 + 合作航司、覆盖 200 + 国家和地区的千万级航线资源,支持实时价格查询、舱等筛选、行程匹配等专业功能,具备企业级高并发稳定性与 7×24 小时服务保障,帮助企业和个人开发者零成本构建具备机票交易能力的 AI 应用。

yorklu/RollingGo_Flight

搜论文Arxiv 袁明伟 (MCP&Agent挑战赛) 班级群2

基于 arXiv 的开放 API 进行论文搜索的

Mic752/ResearchArxivPaper-WithMcp-Mic

自动安装

点击按钮会唤起 PolarBear 客户端,并把当前 MCP Server 的 Markdown 详情文档地址传给客户端。

/api/mcps/falgom4-calendar-mcp/markdown
打开 PolarBear 安装查看 Markdown 文档

手动安装

在 PolarBear 或其他支持 MCP 的客户端中,新建 MCP Server,并参考下方来源或安装提示配置。

暂未识别到安装命令,请打开 ModelScope 详情查看完整配置。

基本信息

分类
calendar-management / app-automation
运行方式
No
许可证
MIT License
详情文件
falgom4-calendar-mcp.md