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 listsget-tasklist
- Get details about a specific task listcreate-tasklist
- Create a new task listupdate-tasklist
- Update an existing task listdelete-tasklist
- Delete a task list
Task Management
list-tasks
- List all tasks in a task listget-task
- Get details about a specific taskcreate-task
- Create a new taskupdate-task
- Update an existing taskdelete-task
- Delete a taskcomplete-task
- Mark a task as completedmove-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
- MacOS:
- Add the Google Tasks MCP server configuration:
Replace the path and credentials with your own values.
3. Build and Run the Server
Installing via Smithery
To install Google Tasks Integration Server for Claude Desktop automatically via Smithery:
Manual Installation
- Install dependencies:
- Build the server:
- 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.
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.
Tools
一个连接 Claude 与 Google Tasks 的模型上下文协议服务器,允许用户直接通过 Claude 界面管理任务列表和任务。
Related MCP Servers
- AsecurityAlicenseAqualityModel 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 -10478192MIT License
- -securityFlicense-qualityA Model Context Protocol server that enables Claude to perform Google Custom Search operations by connecting to Google's search API.Last updated -1
- AsecurityAlicenseAqualityA Model Context Protocol server that allows Claude Desktop to manage and execute tasks in a queue-based system, supporting planning, execution, and completion phases.Last updated -104785MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables Claude to interact with Gmail through a secure OAuth2 connection, providing email management capabilities like listing, sending, deleting, and organizing emails.Last updated -MIT License