google-tasks-mcp
Provides tools for managing Google Tasks lists and tasks, including listing, creating, updating, and deleting tasks and 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.
google-tasks-mcp
An MCP server for Google Tasks, in a single file with no third-party dependencies — Node's built-in modules only.
Tasks created here show up in Google Calendar, so it pairs well with a calendar MCP server: dated events go to the calendar, things you tick off go to Tasks.
Why no dependencies
This server holds an OAuth token for your Google account. Every package it pulled in would be one more thing you'd have to trust with that. The Tasks API is a small REST API and MCP is JSON-RPC over stdio, so neither needs a library. The whole thing is about 250 lines you can read in one sitting.
Related MCP server: google-tasks-mcp
Setup
1. Get an OAuth client
In the Google Cloud console:
Create a project and enable the Google Tasks API (
console.cloud.google.com/apis/library/tasks.googleapis.com)Configure the OAuth consent screen (
/auth/branding) — app name and support email are enoughAdd your own Google account under Audience → Test users (
/auth/audience). Skipping this gives youError 403: access_deniedlaterCreate credentials (
/auth/clients) with application type Desktop app, then download the JSON
Save it as gcp-oauth.keys.json next to server.js, or point
GOOGLE_OAUTH_CREDENTIALS at it.
2. Sign in once
node server.js authA browser opens; sign in and approve. The refresh token is written to tokens.json
beside the server. Nothing is sent anywhere else.
3. Register the server
{
"mcpServers": {
"google-tasks": {
"command": "node",
"args": ["/absolute/path/to/server.js"]
}
}
}Restart your MCP client.
Tools
Tool | What it does |
| List task lists |
| List tasks in a list, optionally including completed ones |
| Create a task — title, notes, due date, optional parent for a subtask |
| Change title, notes, due date, or completion status |
| Delete a task permanently |
| Create a new task list |
Omit tasklist on any call to use @default.
Notes
Due dates are date-only. Google Tasks stores a timestamp but ignores the time part, so pass
YYYY-MM-DDand don't expect a task to fire at a specific hour.While the consent screen is in Testing, authorization expires after 7 days and the refresh token dies with it. Re-run
node server.js auth. Publishing the app removes the limit but requires a homepage and a privacy policy URL, which is usually not worth it for personal use.The requested scope is
.../auth/tasksand nothing else.The OAuth loopback listens on port 3501; override with
GOOGLE_TASKS_MCP_PORT.
Security
tokens.json holds a refresh token for your account. It is gitignored — keep it that
way, and treat it like a password. gcp-oauth.keys.json contains your OAuth client
secret and is gitignored for the same reason.
License
MIT
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
MCP server for Google Tasks: review, plan and tidy your tasks by asking. Deletes always ask first.
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Create, list, and complete todo items through MCP.
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceIntegrates with Google Tasks to enable searching, listing, creating, updating, and deleting tasks through MCP tools. It provides a comprehensive interface for managing task lists and individual task details via the Google Tasks API.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for the Google Tasks API that enables AI agents to read, create, update, delete, and manage Google Tasks.49 npmMIT
- AlicenseNot gradedqualityDmaintenanceProvides an MCP interface to Google Tasks, enabling reading, creating, updating, and completing tasks and task lists, with support for date filtering to generate weekly reports.MIT
- AlicenseNot gradedqualityCmaintenanceEnables read/write access to Google Tasks, including listing, searching, creating, updating, deleting, and clearing tasks, from any MCP-compatible client.MIT