Gtasks Mcp

io.github.alvinjchoi由 GitHub 账号 alvinjchoi 发布v0.2.0更新于 Oct 27, 2026

Manage Google Tasks via MCP: list, search, create, update, move, and clear tasks.

已验证STDIO仅桌面效率与工作流文件与存储

概览

AI 生成的概览

本地 MCP 服务器，让助手读取和管理 Google Tasks：列出、搜索、创建、更新、移动和清除任务。

可以做什么
  • 列出和搜索任务，可限定在单个任务列表，并完整分页
  • 发现任务列表，以树状顺序查看父子层级
  • 创建、更新和删除任务，并清除列表中的已完成任务
  • 重排、嵌套、取消嵌套或在列表之间移动任务
适用场景
适合希望在 Claude Desktop 等桌面 MCP 客户端中让助手操作 Google Tasks 的场景，例如查看待办、在对话中新建任务，或整理列表与子任务。
运行要求
通过 npx 或全局 npm 安装在本地运行（需要 Node.js）。需要启用 Google Tasks API 的 Google Cloud 项目及 OAuth 2.0 桌面凭据，通过 GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET 和 GOOGLE_REFRESH_TOKEN 提供，也可使用凭据文件或主目录配置文件。仅限桌面端。
安装前请注意
需要 Google OAuth 客户端密钥和具备 Tasks 权限范围的刷新令牌；README 建议像对待密码一样对待刷新令牌，不要提交到版本库，泄露后应轮换。助手可以创建、修改、移动、删除任务并清除已完成任务，会改动真实的 Google Tasks 数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Gtasks Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Google Tasks MCP Server

A Model Context Protocol (MCP) server for Google Tasks. Manage task lists and tasks through natural language in Claude Desktop and other MCP clients.

Forked from zcaceres/gtasks-mcp with stronger auth options, multi-list support, pagination, and hierarchy tools.

[图片] [npm version] [MCP Registry] [License: MIT]

Registry name: io.github.alvinjchoi/gtasks-mcp
npm: @alvincrave/gtasks-mcp

Features

  • List and search tasks (optionally scoped to one task list)
  • Paginate through all tasks (no silent 100-task cap)
  • Create, update, delete, and clear completed tasks
  • Discover task lists (list_task_lists)
  • View parent/child hierarchy (list_with_tree)
  • Reorder, nest, or move tasks across lists (move)
  • OAuth2 auth via env vars, credential files, or interactive auth
  • Docker support

Installation

Recommended (Claude Desktop / any MCP client) — runs the latest published npm package:

bash
npx -y @alvincrave/gtasks-mcp

Or install globally:

bash
npm install -g @alvincrave/gtasks-mcp

From source

bash
git clone https://github.com/alvinjchoi/gtasks-mcp.gitcd gtasks-mcpnpm installnpm run build

Setup

Option A — Environment variables (Claude Desktop)

  1. Create a Google Cloud project and enable the Google Tasks API.
  2. Create OAuth 2.0 Desktop credentials and obtain a refresh token (OAuth Playground with scope https://www.googleapis.com/auth/tasks works).
  3. Configure Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
json
{  "mcpServers": {    "gtasks": {      "command": "npx",      "args": ["-y", "@alvincrave/gtasks-mcp"],      "env": {        "GOOGLE_CLIENT_ID": "your_client_id_here",        "GOOGLE_CLIENT_SECRET": "your_client_secret_here",        "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"      }    }  }}

Option B — Credential files (local / shared with other Google MCP servers)

  1. Download your OAuth client JSON (gcp-oauth.keys.json).
  2. Authenticate once:
bash
export GTASKS_CREDENTIALS_PATH=/path/to/gcp-oauth.keys.jsonexport GTASKS_TOKEN_PATH=/path/to/.gtasks-server-credentials.jsonnode dist/index.js auth
  1. Run the server with the same env vars set (or place gcp-oauth.keys.json in the project root and use the defaults).

Aliases also accepted:

PurposePreferredAlias
OAuth client keysGTASKS_CREDENTIALS_PATHGOOGLE_OAUTH_KEYS_PATH
Saved tokensGTASKS_TOKEN_PATHGOOGLE_TASKS_CREDENTIALS_PATH

Option C — Home config file

Create ~/.gtasks-credentials.json:

json
{  "clientId": "your_client_id",  "clientSecret": "your_client_secret",  "refreshToken": "your_refresh_token"}

Tools

ToolDescription
searchSearch tasks by title/notes. Optional taskListId.
listList tasks (all lists, or one via taskListId). Fully paginated.
list_task_listsList task list names and IDs.
list_with_treeTree view for one list (parent/child, position order).
moveReorder, nest/un-nest, or move across lists.
createCreate a task (title required; optional notes/due/taskListId).
updatePatch a task (only provided fields change).
deleteDelete a task.
clearClear completed tasks from a list.

Usage examples

show my task listslist tasks in list <id>search for tasks containing "meeting"create a task named "Prepare presentation" due 2026-07-20show the task tree for list <id>move task <id> under parent <parentId>mark task <id> completed

Docker

bash
docker build -t gtasks-mcp .docker run -i \  -e GOOGLE_CLIENT_ID=your_client_id \  -e GOOGLE_CLIENT_SECRET=your_client_secret \  -e GOOGLE_REFRESH_TOKEN=your_refresh_token \  gtasks-mcp

Development

bash
npm installnpm run buildnpm start

Auth check / interactive login:

bash
npm run buildnode dist/index.js auth

Security Notes

  • Treat refresh tokens like passwords
  • Prefer env vars or ignored credential files — never commit them
  • Rotate credentials if they leak

Contributors

  • ArtyMcLabin — pagination, taskListId filtering, list_task_lists, list_with_tree, move, and file-based auth (#1)
  • zcaceres — original Google Tasks MCP server
  • alvinjchoi — fork maintenance, Smithery/npm packaging

See CONTRIBUTORS.md.

License

MIT

来源：README.md，提交 d88254c

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分