Google Task MCP

一个本地的 MCP 服务器和 Codex 插件，用于列出、创建、更新、完成、取消完成和删除 Google Tasks。它使用 OAuth 2.0，仅请求 Google Tasks 作用域：

https://www.googleapis.com/auth/tasks

环境要求

• Node.js 20 或更高版本

• 一个 Google Cloud 项目

• Codex 或其他支持本地 STDIO 服务器的 MCP 客户端

Related MCP server: Google Tasks MCP Server

Google Cloud 设置

1. 在 Google Cloud 控制台 中，创建或选择一个项目。

2. 在 API 和服务 → 库 下启用 Google Tasks API。

3. 配置 OAuth 同意屏幕。在应用处于测试状态时，将你自己添加为测试用户。

4. 创建一个 桌面应用 类型的 OAuth 客户端 ID。如果客户端配置允许重定向 URI 管理，请将 http://127.0.0.1:53682/oauth2callback 添加为授权的重定向 URI。

安装依赖项

npm install
npm run check

配置凭据

在启动 Codex 的环境中设置以下变量。.env.example 记录了所需的值；该服务器有意不自动加载 .env。

GOOGLE_TASKS_CLIENT_ID
GOOGLE_TASKS_CLIENT_SECRET
GOOGLE_TASKS_REDIRECT_URI=http://127.0.0.1:53682/oauth2callback

可选地，设置 GOOGLE_TASKS_TOKEN_PATH 来选择本地 OAuth 令牌的存储位置。

用作 Codex 插件

该仓库已包含 .codex-plugin/plugin.json 和 .mcp.json。通过本地 Codex 插件市场安装它，然后重启 Codex，以便加载打包好的 STDIO 服务器和工具定义。

对于未打包的开发，直接在 Codex 中使用以下配置服务器：

command: node
args: <absolute-repository-path>/server/index.js

Codex 连接后，调用 google_tasks_get_authorization_url，打开返回的 URL，批准访问，然后调用 google_tasks_complete_authorization。

刷新令牌默认存储在本地 %APPDATA%\google-task-mcp\token.json。设置 GOOGLE_TASKS_TOKEN_PATH 可选择不同的本地路径。删除该文件以断开帐户连接。

工具与安全性

该服务器提供了列出任务列表和任务、创建和更新任务、完成或取消完成任务以及删除任务的工具。除非将 confirm 设置为 true，否则删除操作将被拒绝；调用者应首先显示要删除的确切任务。其他更改会立即应用于 Google Tasks。

OAuth 授权需要保持环回回调监听器运行。浏览器回调会显示一个简单的成功或错误页面，并且绝不会在 URL 或工具输出中暴露令牌。

本地测试

运行 npm run check 进行语法检查。OAuth/API 调用需要配置好的凭据以及交互式浏览器授权。

隐私

OAuth 凭据和任务数据保留在本地机器上，除非是直接发送到 Google API 的请求。切勿提交 .env 或生成的令牌文件。两者都已通过 .gitignore 排除。

许可证

根据 MIT 许可证 发布。