Google Tasks MCP Server

基本能力

产品定位

gtasks-mcp是一个与Google Tasks集成的MCP服务器，旨在通过API提供对Google Tasks的全面管理能力。

核心功能

• 搜索任务：根据查询字符串搜索Google Tasks中的任务。
• 列出任务：列出所有任务，支持分页。
• 创建任务：在指定任务列表中创建新任务，支持设置标题、备注和截止日期。
• 更新任务：修改现有任务的标题、备注、状态或截止日期。
• 删除任务：从指定任务列表中删除任务。
• 清除已完成任务：从任务列表中清除所有已完成的任务。

适用场景

• 自动化任务管理流程
• 集成Google Tasks到其他应用程序
• 批量处理任务操作
• 开发基于Google Tasks的扩展功能

工具列表

• search：搜索Google Tasks中的任务。
• list：列出所有任务。
• create：创建新任务。
• update：更新现有任务。
• delete：删除任务。
• clear：清除已完成任务。

常见问题解答

1. 如何获取Google Tasks API的访问权限？
2. 需要在Google Cloud控制台创建项目并启用Google Tasks API。
3. 如何保存认证信息？
4. 运行npm run start auth完成认证流程后，凭证将自动保存。
5. 如何与桌面应用集成？
6. 在应用的服务器配置中添加gtasks-mcp的命令路径和参数。

使用教程

使用依赖

1. 创建Google Cloud项目
2. 启用Google Tasks API
3. 配置OAuth同意屏幕
4. 添加https://www.googleapis.com/auth/tasks范围
5. 创建"Desktop App"类型的OAuth客户端ID
6. 下载JSON格式的OAuth密钥文件并重命名为gcp-oauth.keys.json，放置在项目根目录

安装教程

通过Smithery自动安装：

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

调试方式

1. 运行认证流程：

npm run start auth

1. 完成后，凭证将保存在.gdrive-server-credentials.json文件中。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。