# Google Tasks MCP

> Google Tasks MCP is an open-source MCP server for productivity. Manage Google Tasks lists, due dates and subtasks from your AI agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** vscode, CLI, self-hosted
- **Website:** https://renzojohnson.com/contributions/google-tasks-mcp
- **MCP Registry name:** com.renzojohnson/google-tasks-mcp
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/google-tasks-mcp
