用途
gtasks-mcp 是一个 Google Tasks 的 Model Context Protocol(MCP)服务器,用于将 Google Tasks 集成到支持 MCP 的客户端(如 Claude),使客户端能够通过工具调用管理 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 中的单个任务,支持读取任务详情,包括标题、状态、截止日期、备注及其他元数据,并可通过上述工具进行列出、读取、创建、更新和删除。
使用方式
准备工作
- 创建新的 Google Cloud 项目。
- 启用 Google Tasks API。
- 配置 OAuth 同意屏幕(测试可使用 "internal")。
- 添加范围 https://www.googleapis.com/auth/tasks。
- 创建应用类型为 "Desktop App" 的 OAuth 客户端 ID。
- 下载客户端 OAuth 密钥的 JSON 文件。
- 将密钥文件重命名为 gcp-oauth.keys.json 并放置到本仓库根目录(即 gcp-oauth.keys.json)。
- 使用 npm run build 或 npm run watch 构建服务器。
通过 Smithery 安装
可通过 Smithery 自动安装 Google Tasks Server 到 Claude Desktop。
认证与保存凭据
运行带 auth 参数的服务器:npm run start auth。这将在系统浏览器中打开认证流程,完成认证后凭据将保存在本仓库根目录(即 .gdrive-server-credentials.json)。
与桌面应用配合使用
要将此服务器与桌面应用集成,请在应用的服务器配置中添加相应配置。
适用场景
适用于需要让支持 MCP 的客户端(如 Claude)帮助管理 Google Tasks 的任务搜索、列表查看、创建、更新、删除及清空已完成任务的场景。
限制
资料未提供关于平台兼容性、收费、价格、性能或效果的具体信息,这些方面暂未提供。