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"](https://en.wikipedia.org/wiki/Vibe_coding) - 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](https://console.cloud.google.com/)
- 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](https://claude.ai/download)
- 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:
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.