Google Tasks MCP
Manage Google Tasks lists, due dates and subtasks from your AI agent
- Pricing
- Open source
- Platforms
- vscode, CLI, self-hosted
- Runs
- Locally
- Version
- 26.11.14
- Listing updated
- 2 days ago
About Google Tasks MCP
Google Tasks MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
Three read tools cover task lists, the tasks inside a list (with due dates, notes, status and subtasks) and a single task. Everything that changes data goes through one tasks_admin tool with seven actions: create, update, complete and move tasks, plus creating and deleting lists. Deleting a task or a list needs confirm: true or nothing happens.
The author lists daily planning, working a task from its notes and a weekly review of finished and overdue items as typical uses. One quirk is documented: Google Tasks stores a due date without a time, so the agent sees the day but not the hour.
It runs locally with your own Google sign-in, either through a VS Code extension that registers it with eight agents or through the npm package on Node.js 22 or newer. Unlike Google Chat, it works with personal Google accounts, and the author states it is not an official Google server.
Install
Run in a terminal
claude mcp add google-tasks-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-tasks-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"google-tasks-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-tasks-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"google-tasks-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-tasks-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"google-tasks-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-tasks-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"google-tasks-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-tasks-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"google-tasks-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-tasks-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Configuration
GOOGLE_APPLICATION_CREDENTIALSPath to a service account key or authorized_user JSON file. Optional if you use gcloud Application Default Credentials or the OAuth variables.GOOGLE_OAUTH_CLIENT_IDOAuth client ID. Set together with the client secret and refresh token.GOOGLE_OAUTH_CLIENT_SECRETOAuth client secret.GOOGLE_OAUTH_REFRESH_TOKENOAuth refresh token with the Google Tasks scopes.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- tasks_list_tasklists
- List your task lists.
- tasks_list_tasks
- List tasks in a list with due dates, notes, status and subtasks.
- tasks_get_task
- Get one task.
- tasks_admin
- Create, update, complete, move and delete tasks and create or delete task lists.
What it does
- Task list reading
- Lists your task lists and the tasks within them.
- Notes and subtasks
- Returns due dates, notes, status and nested subtasks.
- Task creation
- Creates tasks with notes, due date and parent.
- Reorder and nest
- Moves tasks within or between lists.
- Complete tasks
- Marks a task done in one action.
- Confirmed deletes
- Deleting tasks or lists needs explicit confirmation.
Good for
- Ask what is due today
- List overdue tasks
- Add a task due Friday
- Review what was completed last week
- Read a task's notes before starting work
Pricing
Open source
Free, MIT-licensed
Prices change. Check renzojohnson.com before you buy.
Google Tasks MCP FAQ
Does it work with a personal account?
Yes, Google Tasks is available on personal and Workspace accounts.
Can it see the time a task is due?
No, only the due day.
Is it official?
No, it is an independent extension.
How is it set up?
A VS Code wizard needs a Google Cloud OAuth client; the npm package reads credentials from environment variables.
Is Google Tasks MCP free?
Yes. Google Tasks MCP is open source, so you can use and self-host it for free.
How do I add Google Tasks MCP to Claude Code?
Run this command in your terminal: claude mcp add google-tasks-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-tasks-mcp
What are the best alternatives to Google Tasks MCP?
The closest alternatives to Google Tasks MCP are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.
Alternatives to Google Tasks MCP

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media