Google Tasks
About
Manage your Google Tasks with an AI assistant using natural language.
Details
- Author
- alvinjchoi
- Categories
- Productivity, Project Management, Other
Jump to
Option A — Environment variables (Claude Desktop)
- Create a Google Cloud project and enable theGoogle Tasks API. - Create OAuth 2.0 Desktop credentials and obtain a refresh token (OAuth Playground with scopehttps://www.googleapis.com/auth/tasksworks).
- Configure Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS):
{ "mcpServers": { "gtasks": { "command": "npx", "args": ](https://www.npmjs.com/package/@alvincrave/gtasks-mcp)["-y", "@alvincrave/gtasks-mcp"], "env": { "GOOGLE_CLIENT_ID": "your_client_id_here", "GOOGLE_CLIENT_SECRET": "your_client_secret_here", "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here" } } } }
A Model Context Protocol (MCP) server for Google Tasks. Manage task lists and tasks through natural language in Claude Desktop and other MCP clients.
Forked fromzcaceres/gtasks-mcpwith stronger auth options, multi-list support, pagination, and hierarchy tools.
Registry name:io.github.alvinjchoi/gtasks-mcp
npm:@alvincrave/gtasks-mcp
- List and search tasks (optionally scoped to one task list)
- Paginate through all tasks (no silent 100-task cap)
- Create, update, delete, and clear completed tasks
- Discover task lists (list_task_lists)
- View parent/child hierarchy (list_with_tree)
- Reorder, nest, or move tasks across lists (move)
- OAuth2 auth via env vars, credential files, or interactiveauth
- Docker support
Recommended (Claude Desktop / any MCP client) — runs the latest published npm package:
git clone https://github.com/alvinjchoi/gtasks-mcp.git cd gtasks-mcp npm install npm run build
Option A — Environment variables (Claude Desktop)
- Create a Google Cloud project and enable theGoogle Tasks API. - Create OAuth 2.0 Desktop credentials and obtain a refresh token (OAuth Playground with scopehttps://www.googleapis.com/auth/tasksworks).
- Configure Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS):
{ "mcpServers": { "gtasks": { "command": "npx", "args": ["-y", "@alvincrave/gtasks-mcp"], "env": { "GOOGLE_CLIENT_ID": "your_client_id_here", "GOOGLE_CLIENT_SECRET": "your_client_secret_here", "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here" } } } }
Option B — Credential files (local / shared with other Google MCP servers)
- Download your OAuth client JSON (gcp-oauth.keys.json).
- Authenticate once:
export GTASKS_CREDENTIALS_PATH=/path/to/gcp-oauth.keys.json export GTASKS_TOKEN_PATH=/path/to/.gtasks-server-credentials.json node dist/index.js auth
- Run the server with the same env vars set (or placegcp-oauth.keys.jsonin the project root and use the defaults).
{ "clientId": "your_client_id", "clientSecret": "your_client_secret", "refreshToken": "your_refresh_token" }
show my task lists list tasks in list <id> search for tasks containing "meeting" create a task named "Prepare presentation" due 2026-07-20 show the task tree for list <id> move task <id> under parent <parentId> mark task <id> completed
docker build -t gtasks-mcp . docker run -i \ -e GOOGLE_CLIENT_ID=your_client_id \ -e GOOGLE_CLIENT_SECRET=your_client_secret \ -e GOOGLE_REFRESH_TOKEN=your_refresh_token \ gtasks-mcp
- Treat refresh tokens like passwords
- Prefer env vars or ignored credential files — never commit them
- Rotate credentials if they leak
- ArtyMcLabin— pagination,taskListIdfiltering,list_task_lists,list_with_tree,move, and file-based auth (#1)
- zcaceres— original Google Tasks MCP server
- alvinjchoi— fork maintenance, Smithery/npm packaging
Integrate Google services like Gmail, Calendar, Drive, and Tasks with MCP.
Integrate with Google Tasks to manage your to-do lists and tasks.
Interact with Google Tasks to manage your to-do lists and tasks.
Manage Google Tasks from your AI assistant using natural language.
Hosted, Stateless & Multitenant Google Tasks MCP server enables AI assistants to manage tasks and task lists through Google Tasks.
Interact with task, doc, and project data in Dart, an AI-native project management tool
Remote MCP server for MeisterTask. Create and manage projects, tasks, and notes from your AI assistant. Hosted (streamable-HTTP) — connect at https://mcp.meistertask.com/mcp
Remote MCP server for MindMeister. Create, edit, and organize mind maps from your AI assistant. Hosted (streamable-HTTP) — connect at https://mcp.mindmeister.com/mcp
The official Plane MCP server provides integration with Plane APIs, enabling full AI automation of Plane projects, work items, cycles and more.
MCP server to interact with Routine: calendars, tasks, notes, etc.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
