Google Tasks MCP 服务器

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

组件

工具

• 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中的单个任务
  • 支持读取任务详情，包括标题、状态、截止日期、备注和其他元数据
  • 可以使用提供的工具进行列出、读取、创建、更新和删除操作

开始使用

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自动安装适用于Claude Desktop的Google Tasks Server:

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"
      ]
    }
  }
}