gtasks-mcp

🚀 谷歌任务 MCP 服务器

本项目的 MCP 服务器与 Google Tasks 集成，可实现任务的列出、读取、搜索、创建、更新和删除等操作，为用户管理 Google Tasks 提供便利。

🚀 快速开始

环境准备

1. 创建新的 Google Cloud 项目
2. 启用 Google Tasks API
3. 配置 OAuth 同意屏幕（测试时“内部”即可）
4. 添加范围 https://www.googleapis.com/auth/tasks
5. 创建桌面应用类型的 OAuth 客户端 ID
6. 下载客户端的 OAuth 密钥 JSON 文件
7. 将密钥文件重命名为 gcp-oauth.keys.json 并放置在此存储库的根目录中（即 gcp-oauth.keys.json）

构建项目

确保使用 npm run build 或 npm run watch 进行构建。

通过 Smithery 安装

要通过 Smithery 自动安装 Google Tasks Server，可使用以下命令：

npx -y @smithery/cli install @zcaceres/gtasks --desktop

使用说明

• 将服务器二进制文件命名为 gtasks-mcp 并放置在默认的可执行路径中
• 从命令行运行 gtasks-mcp
• 访问 http://localhost:8080 使用 Web 界面

✨ 主要特性

工具

• search

  • 在 Google Tasks 中搜索任务
  • 输入：query（字符串）：搜索查询
  • 返回匹配的任务及其详细信息

• list

  • 列出 Google Tasks 中的所有任务
  • 可选输入：cursor（字符串）：分页游标
  • 返回所有任务的列表

• create

  • 在 Google Tasks 中创建新任务
  • 输入：
    • taskListId（字符串，可选）：任务列表 ID
    • title（字符串，必需）：任务标题
    • notes（字符串，可选）：任务备注
    • due（字符串，可选）：截止日期
  • 返回任务创建确认

• update

  • 更新 Google Tasks 中的现有任务
  • 输入：
    • taskListId（字符串，可选）：任务列表 ID
    • id（字符串，必需）：任务 ID
    • uri（字符串，必需）：任务 URI
    • title（字符串，可选）：新任务标题
    • notes（字符串，可选）：新任务备注
    • status（字符串，可选）：新任务状态（"needsAction" 或 "completed"）
    • due（字符串，可选）：新截止日期
  • 返回任务更新确认

• delete

  • 删除 Google Tasks 中的任务
  • 输入：
    • taskListId（字符串，必需）：任务列表 ID
    • id（字符串，必需）：任务 ID
  • 返回任务删除确认

• clear

  • 从 Google Tasks 任务列表中清除已完成的任务
  • 输入：taskListId（字符串，必需）：任务列表 ID
  • 返回已清除任务的确认

资源

服务器提供对 Google Tasks 资源的访问：

• Tasks (gtasks:///<task_id>)
  • 表示 Google Tasks 中的单个任务
  • 支持读取任务详细信息，包括标题、状态、截止日期、备注和其他元数据
  • 可通过提供的工具进行列出、读取、创建、更新和删除

💻 使用示例

基础用法

# 创建任务
curl -X POST http://localhost:8080/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"title":"完成项目","notes":"需要在周五前完成"}'

# 列出所有任务
curl http://localhost:8080/api/tasks

# 更新任务状态
curl -X PUT http://localhost:8080/api/tasks/123 \
  -H "Content-Type: application/json" \
  -d '{"status":"completed"}'

📦 安装指南

依赖项

• Node.js 和 npm 已安装

建议的命令行工具

• jq ：用于处理 JSON 数据
• curl ：用于发送 HTTP 请求

📚 详细文档

其他注意事项

• 确保你的 Google Cloud 项目已启用 billing
• 安装依赖时使用 npm install
• 使用前请阅读完整的文档和示例