Google Tasks MCP Server

This Model Context Protocol (MCP) server provides a bridge between Claude and Google Tasks, allowing you to manage your task lists and tasks directly through Claude.

Note: All ( bar some edits ) code in this project was "vibe coded" - generated with Claude with instructions from me.

Features

This MCP server provides the following functionality:

Task List Management

list-tasklists - List all your task lists
get-tasklist - Get details about a specific task list
create-tasklist - Create a new task list
update-tasklist - Update an existing task list
delete-tasklist - Delete a task list

Task Management

list-tasks - List all tasks in a task list
get-task - Get details about a specific task
create-task - Create a new task
update-task - Update an existing task
delete-task - Delete a task
complete-task - Mark a task as completed
move-task - Move a task (reorder or change parent)
clear-completed-tasks - Clear all completed tasks from a list

Setup Instructions

1. Create Google Cloud Project & Enable API

Go to the Google Cloud Console
Create a new project
Navigate to "APIs & Services" > "Library"
Search for "Google Tasks API" and enable it
Go to "APIs & Services" > "Credentials"
Click "Create Credentials" > "OAuth Client ID"
Configure the OAuth consent screen (External is fine for personal use)
For Application Type, select "Web application"
Add "http://localhost:3000" as an authorized redirect URI
Create the client ID and secret

2. Configure Claude for Desktop

Install Claude for Desktop
Open the Claude configuration file:
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the Google Tasks MCP server configuration:

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": ["/path/to/google-tasks-mcp/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id_here",
        "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth2callback"
      }
    }
  }
}

Replace the path and credentials with your own values.

3. Build and Run the Server

Install dependencies:

npm install

Build the server:

npm run build

Restart Claude for Desktop

Authentication Flow

When you first use the Google Tasks MCP server:

Use the authenticate tool to get an authorization URL
Visit the URL in your browser and sign in with your Google account
After authorizing, you'll receive a code on the browser page
Use the set-auth-code tool with this code to complete authentication
You can now use all other tools to interact with Google Tasks

Note that your authentication is session-based and will be lost when you restart the server. You'll need to re-authenticate each time.

Requirements

Node.js 14+
Claude for Desktop (latest version)
Google Cloud Project with Tasks API enabled

Screenshot

License

This project is for demonstration purposes only. Use at your own risk.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that bridges Claude with Google Tasks, allowing users to manage task lists and tasks directly through Claude interface.

Related MCP Servers

@kazuph/mcp-taskmanager
kazuph
A
security
A
license
A
quality
Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
Last updated -
10
322
28
JavaScript
MIT License
Notion MCP
Badhansen
-
security
A
license
-
quality
A Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.
Last updated -
13
Python
MIT License
Claude TypeScript MCP Servers
ukkz
A
security
A
license
A
quality
A collection of Model Context Protocol servers that enable Claude Desktop to provide development assistance capabilities with filesystem, Git, shell command, and web search functionality without incurring API usage costs.
Last updated -
2
14
TypeScript
MIT License
Zulip MCP Server
Monadical-SAS
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Zulip workspaces, supporting capabilities such as posting messages, listing channels, sending direct messages, and accessing conversation history.
Last updated -
JavaScript
Apache 2.0

View all related MCP servers

Appeared in Searches

How to interact with Todoist

Google Tasks MCP Server