Google Tasks MCP
Provides tools for reading and managing Google Tasks, including listing and creating task lists and listing, creating, updating, completing, and deleting tasks.
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.
google-tasks-mcp
Self-hosted remote MCP server that lets Claude (web, desktop and the mobile apps) read and manage Google Tasks.
TypeScript, stateless Streamable HTTP (
POST /mcp)OAuth: the server proxies the flow to Google, so there is no database or token store; the MCP bearer token is the Google access token and is verified against Google on each call (cached 60 s)
Single-user: only
ALLOWED_EMAILis acceptedDocker + Caddy (automatic HTTPS) + GitHub Actions
Tools
list_task_lists, create_task_list, list_tasks, create_task, update_task, complete_task, delete_task
Related MCP server: Google Tasks MCP
Setup
1. Google Cloud
Create a project, enable Google Tasks API.
OAuth consent screen: type External, add yourself as a test user (or publish the app, otherwise refresh tokens expire after 7 days in "Testing").
Credentials -> OAuth client ID -> Web application. Authorized redirect URI:
https://<MCP_DOMAIN>/oauth/callback
Google redirects back to this server, which relays the code to Claude with its own issuer as
iss(RFC 9207); Claude rejects a direct redirect carrying Google'siss.Copy the client id and secret.
2. Server (VPS)
git clone https://github.com/<you>/google-tasks-mcp && cd google-tasks-mcp
cp .env.example .env # fill in
docker compose up -d --buildPoint a DNS A record for MCP_DOMAIN at the VPS; Caddy gets the certificate itself.
Check: curl https://mcp.example.com/healthz -> ok.
3. Claude
Settings -> Connectors -> Add custom connector:
URL:
https://mcp.example.com/mcpAdvanced settings: OAuth client ID / secret = the Google ones from step 1
Sign in with the Google account from ALLOWED_EMAIL. Connectors sync to the mobile apps.
Auto-deploy (optional)
CI builds and pushes ghcr.io/<owner>/google-tasks-mcp:latest. To also restart the VPS, set
repo variable DEPLOY_ENABLED=true and secrets DEPLOY_HOST, DEPLOY_USER, DEPLOY_SSH_KEY, DEPLOY_PATH.
Set GITHUB_REPOSITORY=<owner>/google-tasks-mcp in the VPS .env so compose pulls your image.
Development
npm i && cp .env.example .env
npm run dev # needs env vars exported, e.g. `set -a; . ./.env; set +a`
npm run typecheckSecurity notes
Anyone with the URL gets a 401 without a valid Google token for
ALLOWED_EMAIL; tokens for other clients/accounts are rejected.The Google client secret lives only in the server env; keep
.envout of git (store it in OpenBao/Vault if you run one).Scope is
tasks(read/write all tasks) plusopenid emailfor the allowlist check.
Tool 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
Capture, clarify and plan your tasks from Claude or ChatGPT. Built around the GTD methodology.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Multiple Google accounts (Gmail, Calendar, Drive, Contacts, Tasks) in one Claude connector.
Multiple Google accounts (Gmail, Calendar, Drive, Contacts, Tasks) in one Claude connector.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables managing Google Tasks (list, add, complete, delete, update) using natural language commands in Claude Code through an Apps Script webhook.68 npm-
- FlicenseBqualityCmaintenanceConnects Claude to Google Tasks, enabling users to list, create, update, complete, reopen, and delete tasks through natural language.9-
- AlicenseNot gradedqualityCmaintenanceGives Claude seven tools to list, create, update, complete and delete Google Tasks and task lists in your own account, including tasks assigned from Google Docs and Chat. It runs as a remote MCP server you deploy to your own Vercel account, where Claude connects over OAuth with a self-renewing Google sign-in.MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude to view and manage Google Tasks, including lists, tasks, subtasks, due dates, completion, moves, and deletion, through a self-hosted Vercel deployment.1MIT