Google任务管理服务

一个与Google Tasks集成的MCP服务器,提供任务列表、搜索、创建、更新和删除功能。

  • by zcaceres
  • TypeScript
  • 本地部署
  • 174 星标
  • 更新于
在 GitHub 查看 zcaceres/gtasks-mcp

使用说明

谷歌任务MCP服务器

此MCP服务器与Google Tasks集成,允许列出、阅读、搜索、创建、更新和删除任务。

组件

工具

  • 搜索

    • 在谷歌任务中搜索任务
    • 输入: query (string):搜索查询
    • 返回具有详细信息的匹配任务
  • 列表

    • 列出Google任务中的所有任务
    • 可选输入: cursor (string):分页光标
    • 返回所有任务的列表
  • 创建

    • 在Google任务中创建新任务
    • 输入:
      • taskListId (字符串,可选):任务列表ID
      • title (字符串,必填):任务标题
      • notes (字符串,可选):任务注释
      • due (字符串,可选):截止日期
    • 返回任务创建确认
  • 更新

    • 在Google任务中更新现有任务
    • 输入:
      • taskListId (字符串,可选):任务列表ID
      • id (字符串,必填):任务ID
      • uri (字符串,必填):任务URI
      • title (字符串,可选):新任务标题
      • notes (字符串,可选):新任务注释
      • status (字符串,可选):新任务状态(“needsAction”或“completed”)
      • due (字符串,可选):新的截止日期
    • 返回任务更新确认
  • 删除

    • 在Google任务中删除任务
    • 输入:
      • taskListId (字符串,必填):任务列表ID
      • id (字符串,必填):任务ID
    • 返回任务删除确认
  • 清除

    • 从Google任务列表中清除已完成的任务
    • 输入: taskListId (字符串,必填):任务列表ID
    • 返回已清除任务的确认

资源

服务器提供对Google任务资源的访问:

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

入门

  1. 创建新的Google Cloud项目
  2. 启用Google任务API
  3. 配置OAuth同意屏幕 (“内部”适合测试)
  4. 添加作用域 https://www.googleapis.com/auth/tasks
  5. 创建OAuth客户端ID 适用于应用程序类型“桌面应用程序”
  6. 下载客户端OAuth密钥的JSON文件
  7. 将密钥文件重命名为 gcp-oauth.keys.json 并放入此repo的根目录中(即。 gcp-oauth.keys.json)

确保使用以下任一方法构建服务器 npm run build 或 npm run watch.

通过Smithery安装

通过以下方式自动安装Google Tasks Server for Claude Desktop 史密瑟里:

npx -y @smithery/cli install @zcaceres/gtasks --client claude

认证

要验证和保存凭据,请执行以下操作:

  1. 使用运行服务器 auth 论点: npm run start auth
  2. 这将在您的系统浏览器中打开身份验证流
  3. 完成身份验证过程
  4. 凭据将保存在此仓库的根目录中(即。 .gdrive-server-credentials.json)

使用桌面应用程序

要将此服务器与桌面应用程序集成,请将以下内容添加到应用程序的服务器配置中:

{
  "mcpServers": {
    "gtasks": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}