Agenda MCP

谷歌日历中的每日议程

一个简单的Go程序，从谷歌日历中获取并显示您的日常日程。

先决条件

此项目使用 任务 用于任务自动化。先安装：

# macOS
brew install go-task/tap/go-task

# Linux
sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin

# Windows
choco install go-task

# Or install via Go
go install github.com/go-task/task/v3/cmd/task@latest

安装说明

1.启用Google日历API

1. 转到 谷歌云控制台
2. 创建新项目或选择现有项目
3. 启用Google日历API：

- 转到“API和服务”>“库” - 搜索“Google日历API” - 点击它并按“启用”

2.创建凭据

1. 转到“API和服务”>“凭据”
2. 点击“创建凭据”>“OAuth客户端ID”
3. 如果系统提示，请先配置OAuth同意屏幕：

- 选择“外部”用户类型 - 填写所需信息（应用程序名称、用户支持电子邮件、开发人员联系方式） - 将您的电子邮件添加到测试用户

1. 对于应用程序类型，选择“桌面应用程序”
2. 给它起个名字（例如，“每日议程应用程序”）
3. 重要：添加 http://localhost:8080 到“授权重定向URI”
4. 下载JSON文件并将其另存为 credentials.json 在此目录中

3.安装依赖项

task mod-tidy

4.构建应用程序

task build

用法

该程序支持2种模式：

文本模式（显示日历议程）

显示今天的议程：

task run-text
# or directly: ./agenda-mcp text

显示特定日期的议程：

./agenda-mcp text 2024-12-25

日期必须采用YYYY-MM-DD格式。如果没有提供日期，则显示今天的议程。

MCP服务器模式

task run-mcp

首次运行时（身份验证模式）：

1. 该程序将自动打开您的浏览器（如果无法打开，则显示URL）
2. 使用您的Google帐户登录
3. 授予阅读日历的权限
4. 授权将自动完成，您将看到一个成功页面
5. 您的凭据将保存以备将来运行

身份验证后，您可以使用 task run-test 显示您的议程或 task run-mcp 作为MCP服务器运行。

可用任务

跑 task --list 查看所有可用任务：

• task build -构建本地二进制文件
• task clean -清理构建工件
• task mod-tidy -整理并验证go模块
• task run-text -在命令行中显示今天的议程
• task run-mcp -启动MCP服务器
• task inspector -运行npx MCP检查器

MCP检查员

为了调试和测试MCP服务器，您可以使用MCP检查器：

task inspector

这将在以下时间启动MCP检查员http://localhost:8080用于测试MCP服务器功能。

替代方案：直接执行命令

如果您不想使用Task，可以直接运行命令：

# Install dependencies
go mod tidy

# Run modes directly
go run main.go text              # Show today's agenda
go run main.go text 2024-12-25   # Show agenda for specific date
go run main.go mcp               # Start MCP server

特性

• 📅 按时间顺序显示今天的事件
• 🕐 显示事件时间（或全天事件的“全天”）
• 🎨 显示事件颜色和您的实际类别名称（焦点时间、内部小组会议、外部会议、个人会议等）
• 📍 显示事件位置（如果可用）
• 📝 显示事件描述（截断为100个字符）
• 👥 列出与会者及其响应状态(✅ 认可的，❌ 拒绝，❓ 实验性的，⏳ 待定）
• 👁️ 显示事件可见性设置
• ⏱️ 显示透明度设置（忙/闲）
• 🎉 未安排活动时的友好消息
• 🔌 MCP服务器：通过模型上下文协议公开日历数据，以便与LLM应用程序集成

MCP服务器模式

在MCP模式下运行时(task run-mcp)，该程序充当模型上下文协议服务器，可以与Claude等LLM应用程序集成，提供两个日历工具：

可用的MCP工具

1. get_todays_agenda -从谷歌日历获取今天的日历议程
2. get_agenda_for_date -获取特定日期的日历议程（YYYY-MM-DD格式）

MCP集成

将此添加到MCP客户端配置中：

{
  "mcpServers": {
    "google-calendar": {
      "command": "/path/to/your/agenda-mcp",
      "args": ["mcp"],
      "env": {
        "client_id": "your-google-oauth-client-id",
        "project_id": "your-google-project-id",
        "client_secret": "your-google-oauth-client-secret"
      }
    }
  }
}

备注：替换 /path/to/your/agenda-mcp 使用构建的二进制文件的实际完整路径，并使用来自的Google OAuth凭据设置环境变量 credentials.json 文件。

这允许LLM应用程序：

• 使用以下工具获取您的每日谷歌日历议程 get_todays_agenda 工具
• 使用获取任何特定日期的日历事件 get_agenda_for_date 带有日期参数的工具（例如“2024-12-25”）

安全说明

• 保持 credentials.json 和 token.json 私有的
• 不要将这些文件提交到版本控制
• 该程序仅请求对您的日历进行只读访问