Google Tasks MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Allows listing, reading, searching, creating, updating, and deleting tasks in Google Tasks. Supports accessing task details including title, status, due date, notes, and other metadata.

Google Tasks MCP 服务器

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

成分

工具

  • 搜索
    • 在 Google Tasks 中搜索任务
    • 输入: query (字符串):搜索查询
    • 返回匹配的任务及其详细信息
  • 列表
    • 列出 Google Tasks 中的所有任务
    • 可选输入: cursor (字符串):分页光标
    • 返回所有任务的列表
  • 创造
    • 在 Google Tasks 中创建新任务
    • 输入:
      • taskListId (字符串,可选):任务列表 ID
      • title (字符串,必需):任务标题
      • notes (字符串,可选):任务注释
      • due (字符串,可选):到期日
    • 返回任务创建确认
  • 更新
    • 更新 Google Tasks 中的现有任务
    • 输入:
      • taskListId (字符串,可选):任务列表 ID
      • id (字符串,必需):任务 ID
      • uri (字符串,必需):任务 URI
      • title (字符串,可选):新任务标题
      • notes (字符串,可选):新任务注释
      • status (字符串,可选):新任务状态(“needsAction”或“completed”)
      • due (字符串,可选):新的截止日期
    • 返回任务更新确认
  • 删除
    • 在 Google Tasks 中删除任务
    • 输入:
      • taskListId (字符串,必需):任务列表 ID
      • id (字符串,必需):任务 ID
    • 返回任务删除确认
  • 清除
    • 从 Google Tasks 任务列表中清除已完成的任务
    • 输入: taskListId (字符串,必需):任务列表ID
    • 返回已清除任务的确认

资源

该服务器提供对 Google 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并将其放入此 repo 的根目录中(即gcp-oauth.keys.json

确保使用npm run buildnpm 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. 凭证将保存在此 repo 的根目录中(即.gdrive-server-credentials.json

与桌面应用程序一起使用

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

{ "mcpServers": { "gtasks": { "command": "/opt/homebrew/bin/node", "args": [ "{ABSOLUTE PATH TO FILE HERE}/dist/index.js" ] } } }
-
security - not tested
A
license - permissive license
-
quality - not tested

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

  1. Components
    1. Tools
    2. Resources
  2. Getting started
    1. Installing via Smithery
    2. Authentication
    3. Usage with Desktop App
ID: 1tqi5yij3g