This server allows you to manage your Google Tasks directly through Claude. You can:
- Authentication: Connect to your Google Tasks account using OAuth flow
- Task List Management:
- List all your task lists
- Get details about specific task lists
- Create new task lists
- Update existing task lists (change title)
- Delete task lists
- Task Management:
- List tasks within a list (with options for hidden, deleted, or completed tasks)
- Get details about specific tasks
- Create new tasks (with title, notes, and due date)
- Update existing tasks
- Delete tasks
- Mark tasks as completed
- Move tasks to reorder or change parent
- Clear completed tasks from a list
Provides tools for task list management (listing, creating, updating, deleting task lists) and task management (listing, creating, updating, deleting, completing, moving tasks and clearing completed tasks).
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
- 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.
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
- 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 -101,39728JavaScriptMIT License
- AsecurityFlicenseAqualityA TypeScript Model Context Protocol server that integrates with Google Tasks API, allowing users to create, list, update, delete, and toggle completion status of tasks.Last updated -43JavaScript
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants like Claude to interact with Google Cloud Platform environments through natural language, allowing users to query and manage GCP resources during conversations.Last updated -910262TypeScriptMIT 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 -Python