Google Tasks MCP Server

An MCP server for managing Google Tasks tasklists and tasks, designed to work with AI assistants through the Model Context Protocol.

Features

• Tasklists: List, create, get, and delete tasklists.
• Tasks: List, create, get, update, complete, and delete tasks.
• Filtering: Filter task results by due/completed windows and visibility flags.
• Validation: Input validation for required fields and RFC3339 date values.
• Retry Handling: Automatic retries for transient Google API errors.

Installation

Prerequisites

• Python 3.10 or higher.
• A Google Cloud Project with the Google Tasks API enabled.
• OAuth2 credentials (Client ID and Client Secret).
• OAuth scope: ["https://www.googleapis.com/auth/tasks"].

Local Setup

1. Install dependencies:

   pip install -e .
   

2. Run the server:

   python server.py --access-token <TOKEN> --refresh-token <REFRESH_TOKEN> --client-id <CLIENT_ID> --client-secret <CLIENT_SECRET>
   

Configuration

Add the following to your MCP host configuration (for example, mcp-config.json):

{
  "mcpServers": {
    "barie-google-tasks-mcp": {
      "command": "uvx",
      "args": [
        "barie-google-tasks-mcp",
        "--access-token",
        "YOUR_ACCESS_TOKEN",
        "--refresh-token",
        "YOUR_REFRESH_TOKEN",
        "--client-id",
        "YOUR_CLIENT_ID",
        "--client-secret",
        "YOUR_CLIENT_SECRET"
      ]
    }
  }
}

Tools

• list-tasklists: List available tasklists.
• get-tasklist: Get details for a single tasklist.
• create-tasklist: Create a new tasklist.
• delete-tasklist: Delete a tasklist.
• list-tasks: List tasks in a tasklist with optional filters.
• get-task: Get details for one task.
• create-task: Create a task in a tasklist.
• update-task: Update selected task fields.
• complete-task: Mark a task as completed.
• delete-task: Delete a task.

Notes:

• Use @default as tasklistId to target the default Google Tasks list.
• Date fields must use RFC3339 format (for example: 2026-05-07T09:00:00Z).

License

MIT