Google Tasks
About
Manage your Google Tasks with an AI assistant using natural language.
Explore
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Google TasksCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- 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" } } } }
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"google tasks": {
"server": {
"command": "npx",
"args": [
"-y",
"@alvincrave/gtasks-mcp"
],
"env": {
"GOOGLE_CLIENT_ID": "",
"GOOGLE_CLIENT_SECRET": "",
"GOOGLE_REFRESH_TOKEN": ""
}
}
}
}
}McpServers
{
"server": {
"command": "npx",
"args": [
"-y",
"@alvincrave/gtasks-mcp"
],
"env": {
"GOOGLE_CLIENT_ID": "",
"GOOGLE_CLIENT_SECRET": "",
"GOOGLE_REFRESH_TOKEN": ""
}
}
}Transport
"stdio"Package
"@alvincrave/gtasks-mcp"Registry
"npm"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.
