gtasks-mcp
Provides tools for managing Google Tasks, including listing, searching, creating, updating, deleting, and clearing tasks across task lists.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
gtasks-mcp
Status: abandoned. This repository is no longer maintained (last commit 1 September 2026) and is not recommended for real use. It stays online as a POC: the code, the test suite and the credentials-out-of-the-repo setup may still be useful to anyone starting from zcaceres/gtasks-mcp.
A Model Context Protocol server for Google Tasks — list, search, create, update, delete, and clear tasks from Claude (or any MCP-compatible client).
Adapted from zcaceres/gtasks-mcp (MIT), rebuilt on plain Node/TypeScript instead of Bun, with credentials moved out of the repo entirely (see Security below) and a full test suite.
Setup
1. Create a Google Cloud OAuth client
Go to the Google Cloud Console, create a project (or reuse one).
Enable the Google Tasks API (APIs & Services → Library).
Configure the OAuth consent screen (External is fine for personal use — you'll be the only test user).
Create credentials → OAuth client ID → Application type Desktop app.
Download the JSON file.
2. Install the OAuth client file
mkdir -p ~/.gtasks-mcp
mv ~/Downloads/client_secret_*.json ~/.gtasks-mcp/oauth-keys.jsonOn Windows: %USERPROFILE%\.gtasks-mcp\oauth-keys.json.
3. Build and authenticate
npm install
npm run build
npm run authThis opens a browser window for the Google consent flow. On success, a credentials.json (your refresh/access token) is written next to oauth-keys.json in ~/.gtasks-mcp/.
4. Register the server with Claude Code
claude mcp add gtasks -- node /absolute/path/to/gtasks-mcp/dist/index.jsRelated MCP server: google-task-mcp
Tools exposed
Tool | Description |
| List tasks (all lists, or one via |
| Search tasks by title/notes |
| List all task lists |
| Create a task ( |
| Update a task ( |
| Delete a task ( |
| Clear completed tasks from a list |
Security
Credentials never live inside this repo.
oauth-keys.json(your Google Cloud OAuth client) andcredentials.json(your personal access/refresh token, generated bynpm run auth) are both stored under~/.gtasks-mcp/— the OS user-config area, not the project directory. There is no gitignored file inside the repo to accidentallygit add -f; the secrets aren't reachable from the repo's working tree at all. Seesrc/config.tsfor the exact paths.credentials.jsonis equivalent to a password to your Google Tasks — anyone with that file can read/write your tasks. Treat it accordingly (don't email it, don't paste it in a chat, don't back it up somewhere shared).Dependencies: only
@google-cloud/local-auth,googleapis, and@modelcontextprotocol/sdk— all official (Google / Anthropic). No telemetry, no third-party network calls; every request goes to Google's own APIs.Known, accepted transitive vulnerabilities (
npm audit, checked 2026-08-25): moderate-severity issues inesbuild/vite(dev-only tooling, not part of the runtime) anduuid(viagaxios/googleapis, no untrusted-buffer input path in this server's actual usage). Both require a breaking major-version bump upstream to clear; revisit at the next periodic dependency audit rather than force an untested upgrade.
Development
npm test # vitest
npm run lint # eslint (narrow scope — see eslint.config.js)
npm run typecheck
npm run buildTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for Google Tasks: review, plan and tidy your tasks by asking. Deletes always ask first.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Tasks, notes, and tags in TodoNote, with OAuth-scoped read and write access.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for Google Tasks that enables reading, creating, editing, completing, reordering, and deleting tasks via the Google Tasks API.1427 npm2MIT
- AlicenseAqualityCmaintenanceEnables managing Google Tasks (list, create, update, complete, uncomplete, delete) via OAuth 2.0 authorization.8MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to manage Google Tasks, including creating, updating, deleting, and listing tasks and task lists, with optional due dates and subtasks.MIT
- AlicenseNot gradedqualityBmaintenanceEnables full read/write access to Google Tasks from any MCP client, including creating, updating, completing, deleting, and moving tasks and task lists with real due dates.153 npm4MIT