使用说明
谷歌任务MCP服务器
此MCP服务器与Google Tasks集成,允许列出、阅读、搜索、创建、更新和删除任务。
组件
工具
-
搜索
- 在谷歌任务中搜索任务
- 输入:
query(string):搜索查询 - 返回具有详细信息的匹配任务
-
列表
- 列出Google任务中的所有任务
- 可选输入:
cursor(string):分页光标 - 返回所有任务的列表
-
创建
- 在Google任务中创建新任务
- 输入:
taskListId(字符串,可选):任务列表IDtitle(字符串,必填):任务标题notes(字符串,可选):任务注释due(字符串,可选):截止日期
- 返回任务创建确认
-
更新
- 在Google任务中更新现有任务
- 输入:
taskListId(字符串,可选):任务列表IDid(字符串,必填):任务IDuri(字符串,必填):任务URItitle(字符串,可选):新任务标题notes(字符串,可选):新任务注释status(字符串,可选):新任务状态(“needsAction”或“completed”)due(字符串,可选):新的截止日期
- 返回任务更新确认
-
删除
- 在Google任务中删除任务
- 输入:
taskListId(字符串,必填):任务列表IDid(字符串,必填):任务ID
- 返回任务删除确认
-
清除
- 从Google任务列表中清除已完成的任务
- 输入:
taskListId(字符串,必填):任务列表ID - 返回已清除任务的确认
资源
服务器提供对Google任务资源的访问:
- 任务 (
gtasks:///<task_id>)- 表示Google任务中的单个任务
- 支持读取任务详细信息,包括标题、状态、截止日期、注释和其他元数据
- 可以使用提供的工具列出、读取、创建、更新和删除
入门
- 创建新的Google Cloud项目
- 启用Google任务API
- 配置OAuth同意屏幕 (“内部”适合测试)
- 添加作用域
https://www.googleapis.com/auth/tasks - 创建OAuth客户端ID 适用于应用程序类型“桌面应用程序”
- 下载客户端OAuth密钥的JSON文件
- 将密钥文件重命名为
gcp-oauth.keys.json并放入此repo的根目录中(即。gcp-oauth.keys.json)
确保使用以下任一方法构建服务器 npm run build 或 npm run watch.
通过Smithery安装
通过以下方式自动安装Google Tasks Server for Claude Desktop 史密瑟里:
npx -y @smithery/cli install @zcaceres/gtasks --client claude
认证
要验证和保存凭据,请执行以下操作:
- 使用运行服务器
auth论点:npm run start auth - 这将在您的系统浏览器中打开身份验证流
- 完成身份验证过程
- 凭据将保存在此仓库的根目录中(即。
.gdrive-server-credentials.json)
使用桌面应用程序
要将此服务器与桌面应用程序集成,请将以下内容添加到应用程序的服务器配置中:
{
"mcpServers": {
"gtasks": {
"command": "/opt/homebrew/bin/node",
"args": [
"{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
]
}
}
}