Google Tasks MCP Server

Google Tasks MCP Server

site icon
2025.04.04 0
Python任务管理AI助手集成日程管理
Google Tasks MCP Server 是一个基于Python构建的Model Context Protocol (MCP)服务器,允许大型语言模型(如Claude.ai)与Google Tasks API进行交互。该服务器提供了一套工具,使AI助手能够直接管理用户的Google Tasks。
View on GitHub

Overview

基本能力

产品定位

Google Tasks MCP Server 是一个用于任务管理的MCP服务器,旨在通过AI助手帮助用户更高效地管理Google Tasks。

核心功能

  • 列出所有Google Task列表
  • 创建新的任务列表
  • 查看特定列表中的任务
  • 添加新任务(包括标题、备注和截止日期)
  • 标记任务为已完成
  • 在列表之间移动任务

适用场景

  • 任务优先级排序:让AI助手根据截止日期和重要性分析和优先排序任务
  • 任务组织:让AI助手为不同项目创建和组织任务列表
  • 任务管理:在对话中请求AI添加、更新或完成任务
  • 任务摘要:获取不同列表中即将到来的任务的摘要
  • 任务规划:与AI合作,根据现有任务规划一天或一周的工作

工具列表

该MCP服务器提供了一套工具,使AI助手能够直接管理用户的Google Tasks,包括任务列表管理、任务创建、任务更新和任务移动等功能。

常见问题解答

  1. 如何确保安全性?
  2. credentials.jsontoken.json文件包含敏感的身份验证信息,应妥善保管。
  3. 这些文件已被包含在.gitignore文件中,以防止意外提交。

使用教程

使用依赖

  • Python 3.8或更高版本
  • Google Cloud Console账户
  • 已启用的Google Tasks API

安装教程

  1. 克隆仓库: git clone https://github.com/andiazo/mcp_google_tasks.git cd mcp_google_tasks

  2. 创建并激活虚拟环境: uv venv source .venv/bin/activate # Windows: .venv\Scripts\activate

  3. 安装依赖: uv add install -r requirements.txt

  4. Google Cloud Console设置:

  5. 创建新项目或选择现有项目
  6. 为项目启用Google Tasks API
  7. 创建OAuth 2.0凭据
  8. 下载凭据JSON文件并重命名为credentials.json,放置在项目根目录

调试方式

  1. 启动MCP服务器: uv run google_tasks.py

  2. 首次运行时,系统会提示授权应用程序:

  3. 浏览器窗口将打开
  4. 使用Google账户登录
  5. 授予请求的权限
  6. 授权将保存到token.json以供将来使用

  7. 服务器现在已运行并准备好连接到AI助手

连接到AI助手

此MCP服务器可与任何支持Model Context Protocol的AI助手(如Claude.ai)一起使用。按照AI平台的特定说明连接到自定义工具。

Claude: https://modelcontextprotocol.io/quickstart/server

许可证

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