AI导哈

日历管理工具

基于Google Calendar API v3的日历管理服务器，提供事件CRUD、可用性查询等10种工具。

  • by jeffmm
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 jeffmm/gcal-fast-mcp

使用说明

gcal快速mcp

谷歌日历MCP服务器内置 FastMCP.通过Google calendar API v3为日历管理、事件CRUD和可用性查询提供了10个工具。

设置

1.谷歌OAuth凭据

将您的Google Cloud OAuth客户端凭据放置在 ~/.gcal-mcp/gcp-oauth.keys.json （或者在项目目录中——它们将被自动复制）。

如果你已经为另一个Google API配置了GCP项目（例如gmail-fast-mcp），你可以重用同一个OAuth客户端-只需在该项目中启用Google Calendar API即可。

2.身份验证

uv run python -m gcal_fast_mcp auth

这将打开OAuth流的浏览器，并将令牌保存到 ~/.gcal-mcp/credentials.json.

对于具有自定义回调URL的云环境：

uv run python -m gcal_fast_mcp auth https://your-domain.com/oauth2callback

3.运行服务器

uv run python -m gcal_fast_mcp

MCP客户端配置

{
  "mcpServers": {
    "google-calendar": {
      "command": "uv",
      "args": ["--directory", "/path/to/gcal-fast-mcp", "run", "google-calendar-fast-mcp"]
    }
  }
}

工具

工具 说明
list_calendars 列出用户有权访问的所有日历
get_calendar 获取特定日历的详细信息
list_events 列出时间范围内的事件（支持搜索、重复扩展）
get_event 获取单个事件的完整详细信息
create_event 创建一个包含与会者、地点等信息的新活动。
update_event 更新现有事件（支持部分更新）
delete_event 删除事件
quick_add 用自然语言创建一个事件（例如“明天中午的午餐”）
check_availability 检查一个或多个日历的忙/闲状态

配置

环境变量（前缀 GCAL_):

变量 默认值 描述
GCAL_OAUTH_PATH ~/.gcal-mcp/gcp-oauth.keys.json OAuth客户端机密文件
GCAL_CREDENTIALS_PATH ~/.gcal-mcp/credentials.json 已保存OAuth令牌
GCAL_DEFAULT_CALENDAR primary 默认日历ID
GCAL_MAX_RESULTS 50 返回默认最大事件数

Google日历API范围

  • calendar --完全日历访问
  • calendar.events --事件CRUD操作

相关 MCP