https://github.com/arpitbatra123/mcp-googletasks
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.
https://github.com/arpitbatra123/mcp-googletasks
Last synced: 19 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/arpitbatra123/mcp-googletasks
- Owner: arpitbatra123
- License: mit
- Created: 2025-03-18T17:22:05.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-04-23T09:00:27.000Z (about 1 month ago)
- Last Synced: 2025-05-07T00:12:07.859Z (25 days ago)
- Language: TypeScript
- Homepage:
- Size: 1.5 MB
- Stars: 6
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-list - arpitbatra123/mcp-googletasks - googletasks?style=social)](https://github.com/arpitbatra123/mcp-googletasks): Interfaces with the Google Tasks API for task management. (Uncategorized / Uncategorized)
- awesome-mcp-zh - arpitbatra123/mcp-googletasks
- awesome-mcp-servers - arpitbatra123/mcp-googletasks - 📇 ☁️ - An MCP server to interface with the Google Tasks API (Legend / 💬 <a name="communication"></a>Communication)
- awesome-mcp-servers - ClaudeTasks - Manages Google Tasks via Claude, enabling creation, updating, and deletion of tasks and lists (Table of Contents / Workflow Automation)
- awesome-mcp-servers - ClaudeTasks - Manages Google Tasks via Claude, enabling creation, updating, and deletion of tasks and lists (Table of Contents / Workflow Automation)
README
# 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
1. Go to the [Google Cloud Console](https://console.cloud.google.com/)
2. Create a new project
3. Navigate to "APIs & Services" > "Library"
4. Search for "Google Tasks API" and enable it
5. Go to "APIs & Services" > "Credentials"
6. Click "Create Credentials" > "OAuth Client ID"
7. Configure the OAuth consent screen (External is fine for personal use)
8. For Application Type, select "Web application"
9. Add "http://localhost:3000" as an authorized redirect URI
10. Create the client ID and secret
### 2. Configure Claude for Desktop
1. Install [Claude for Desktop](https://claude.ai/download)
2. Open the Claude configuration file:
- MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
3. Add the Google Tasks MCP server configuration:
```json
{
"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
1. Install dependencies:
```bash
npm install
```
2. Build the server:
```bash
npm run build
```
3. Restart Claude for Desktop
## Authentication Flow
When you first use the Google Tasks MCP server:
1. Use the `authenticate` tool to get an authorization URL
2. Visit the URL in your browser and sign in with your Google account
3. After authorizing, you'll receive a code on the browser page
4. Use the `set-auth-code` tool with this code to complete authentication
5. 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.