Google Tasks MCP

Google Tasks MCP is a free MCP server that gives your AI agent three tools for Google Tasks. Your agent can see your task lists and the tasks in them, with due dates, notes, status, and subtasks, so your to-do list is in view while you work. It can also make changes, such as adding a task or marking one done, with a confirmation step for anything destructive. It is its own VS Code extension, it runs on your machine, and it uses your own Google account.

There is no server to host and no config file to edit. You install the extension, sign in to Google once, and the tools appear in every agent it finds: VS Code Copilot, Claude Code, Cursor, OpenAI Codex, Google Gemini, Windsurf, Continue.dev, and Cline.

What you can ask

  • “What is on my task list today?”
  • “Which tasks are overdue?”
  • “Show everything due this week”
  • “What are the notes on the invoice task?”
  • “Add a task to review the pull request, due Friday”
  • “Mark the invoice task as done”

The three Google Tasks MCP tools

Tool What it does What you can pass
tasks_list_tasklists List your task lists A page size
tasks_list_tasks List the tasks in a list with due dates, notes, status, and subtasks A list (your default list if you name none), whether to include completed tasks, a due-date window
tasks_get_task Get one task The task ID and its list

The Google Tasks admin tool

Changes go through one tool, tasks_admin, with named actions.

Action What it does
create_task Create a task, with notes, a due date, and a parent if you give them
update_task Change a task’s title, notes, due date, or status
complete_task Mark a task as done
move_task Reorder a task, nest it under another, or move it to another list
delete_task Delete a task (needs confirmation)
create_tasklist Create a task list
delete_tasklist Delete a task list and its tasks (needs confirmation)

Destructive actions need explicit confirmation

delete_task and delete_tasklist only run with confirm: true. Without it the server changes nothing and returns a warning, so the agent has to ask you first. Reading never needs it.

Three things people use it for

Starting the day in the editor

Ask what is due today and the agent reads your default list. You can follow with “which of these is about this repository?” and it picks them out.

Working a task from its notes

Tasks often hold the detail in their notes: a link, a ticket number, a client’s wording. The agent reads the note and starts on the work.

A weekly review

Ask for completed tasks from the last seven days and the ones still open and overdue. It is a quick way to write a status update.

Set it up in five steps

A setup wizard opens the first time you launch the extension. OAuth is the usual choice.

  1. Create a project in the Google Cloud Console, or pick one you already have.
  2. Enable the Google Tasks API under APIs and Services.
  3. Create an OAuth client ID of type Desktop app.
  4. Paste the client ID and secret into the wizard.
  5. Sign in to Google in the browser window that opens, and authorize.

If your consent screen is set to External, add yourself as a test user first. The wizard also accepts Application Default Credentials from the gcloud CLI and a service account key.

Using Google Tasks MCP with Claude Code, Cursor and other agents

You do not add a server entry by hand. The extension writes the registration for each agent it finds: ~/.claude.json for Claude Code, ~/.cursor/mcp.json for Cursor, ~/.codex/config.toml for OpenAI Codex, ~/.gemini/settings.json for Gemini, and the matching files for Windsurf, Continue.dev, and Cline. VS Code Copilot picks it up through the VS Code API.

Open a new session in any of them and the tools are in the tool list. To limit which agents get them, switch the others off in VS Code settings under googleTasksMcp.agents. The command “Google Tasks MCP: Remove from All Agents” takes every registration back out.

Limits

  • Google Tasks stores a due date without a time, so the agent sees the day a task is due and no hour.

Common questions

Is Google Tasks MCP free?

Yes. The extension is free and MIT licensed.

Is this an official Google server?

No. It is an independent extension that calls the Google Tasks API with your own sign-in.

Does it work with a personal Google account?

Yes. Google Tasks is available on personal and Workspace accounts.

Does it work with Claude Code and Cursor?

Yes. Both are registered automatically, along with Copilot and five other agents.

Where does my data go?

Nowhere except Google. The MCP server runs on your own machine and calls Google’s API with your credentials. There is no telemetry, and the sign-in token is kept in VS Code’s encrypted secret storage.

Install it

Google Tasks MCP is free and MIT licensed.

Related