Skip to content

Latest commit

 

History

History
106 lines (80 loc) · 3.26 KB

README.md

File metadata and controls

106 lines (80 loc) · 3.26 KB

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

  1. Go to the Google Cloud Console
  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
  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:
{
  "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:
npm install
  1. Build the server:
npm run build
  1. 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.