barie-google-tasks-mcp 0.1.1

Production-grade Google Tasks MCP server (manage tasklists and tasks via the Model Context Protocol).

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