Google Tasks MCP Server
2025.05.05
0
TypeScript任务管理AI 集成日程管理
Google Tasks MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，旨在为 AI 助手提供与 Google Tasks 交互的能力。通过该服务，用户可以通过自然语言命令管理任务列表和任务，包括创建、更新、删除、搜索等操作。该服务支持 OAuth2 认证、并行 API 请求以提高性能，并提供了全面的错误处理和类型安全的 TypeScript 接口。
View on GitHub
Overview
基本能力
产品定位
Google Tasks MCP Server 是一个连接 AI 助手与 Google Tasks 的中间件服务，旨在通过自然语言交互简化任务管理流程。
核心功能
- 任务列表管理：创建、更新、删除和列出任务列表
- 任务管理：创建、更新、删除、搜索和移动任务
- 任务组织：支持父子任务关系
- 详细任务信息查看：查看任务的详细信息
- 清除已完成任务：一键清除已完成任务
- 认证与安全：OAuth2 认证并支持自动刷新令牌
- 性能优化：并行 API 请求提高性能
- 类型安全：TypeScript 接口确保类型安全
- 错误处理：全面的错误处理机制
- AI 集成：通过 MCP 协议与 AI 助手集成
适用场景
- 通过自然语言管理 Google Tasks
- 在 AI 助手（如 Claude）中集成任务管理功能
- 自动化任务创建和更新
- 批量操作任务
- 任务优先级管理
工具列表
- tasklist.list：列出所有任务列表
- tasklist.get：通过 ID 获取任务列表
- tasklist.create：创建新任务列表
- tasklist.update：更新任务列表
- tasklist.delete：删除任务列表
- task.search：通过标题或备注搜索任务
- task.list：列出所有任务
- task.get：通过 ID 获取任务
- task.create：创建新任务
- task.update：更新现有任务
- task.move：移动任务（更改父任务或位置）
- task.delete：删除任务
- task.clear：清除已完成任务
常见问题解答
- 认证问题：确保
.env文件中有正确的CLIENT_ID、CLIENT_SECRET和REDIRECT_URI - 连接问题：在连接 Claude 之前确保服务器正在运行
- 命令未找到：确保 Claude Desktop CLI 在 PATH 中
- MCP 协议错误：检查服务器日志以获取详细信息
使用教程
使用依赖
# Clone the repository
git clone https://github.com/overlay-one/google-tasks-mcp-server.git
cd google-tasks-mcp-server
# Install dependencies
pnpm install
安装教程
# Build the project
pnpm build
# Production mode
pnpm start
# Development mode (with auto-reloading)
pnpm dev
调试方式
# Run all tests (this will first build the TypeScript code)
pnpm test
# Run tests in watch mode for development
pnpm test:watch