workspace-mcp 1.1.3__py3-none-any.whl → 1.1.4__py3-none-any.whl

auth/scopes.py

@@ -52,6 +52,10 @@ FORMS_RESPONSES_READONLY_SCOPE = 'https://www.googleapis.com/auth/forms.response
 SLIDES_SCOPE = 'https://www.googleapis.com/auth/presentations'
 SLIDES_READONLY_SCOPE = 'https://www.googleapis.com/auth/presentations.readonly'
 
+# Google Tasks API scopes
+TASKS_SCOPE = 'https://www.googleapis.com/auth/tasks'
+TASKS_READONLY_SCOPE = 'https://www.googleapis.com/auth/tasks.readonly'
+
 # Base OAuth scopes required for user identification
 BASE_SCOPES = [
     USERINFO_EMAIL_SCOPE,
@@ -104,5 +108,10 @@ SLIDES_SCOPES = [
     SLIDES_READONLY_SCOPE
 ]
 
+TASKS_SCOPES = [
+    TASKS_SCOPE,
+    TASKS_READONLY_SCOPE
+]
+
 # Combined scopes for all supported Google Workspace operations
-SCOPES = list(set(BASE_SCOPES + CALENDAR_SCOPES + DRIVE_SCOPES + GMAIL_SCOPES + DOCS_SCOPES + CHAT_SCOPES + SHEETS_SCOPES + FORMS_SCOPES + SLIDES_SCOPES))
+SCOPES = list(set(BASE_SCOPES + CALENDAR_SCOPES + DRIVE_SCOPES + GMAIL_SCOPES + DOCS_SCOPES + CHAT_SCOPES + SHEETS_SCOPES + FORMS_SCOPES + SLIDES_SCOPES + TASKS_SCOPES))

auth/service_decorator.py

@@ -18,7 +18,8 @@ from auth.scopes import (
     SHEETS_READONLY_SCOPE, SHEETS_WRITE_SCOPE,
     CHAT_READONLY_SCOPE, CHAT_WRITE_SCOPE, CHAT_SPACES_SCOPE,
     FORMS_BODY_SCOPE, FORMS_BODY_READONLY_SCOPE, FORMS_RESPONSES_READONLY_SCOPE,
-    SLIDES_SCOPE, SLIDES_READONLY_SCOPE
+    SLIDES_SCOPE, SLIDES_READONLY_SCOPE,
+    TASKS_SCOPE, TASKS_READONLY_SCOPE
 )
 
 # Service configuration mapping
@@ -30,7 +31,8 @@ SERVICE_CONFIGS = {
     "sheets": {"service": "sheets", "version": "v4"},
     "chat": {"service": "chat", "version": "v1"},
     "forms": {"service": "forms", "version": "v1"},
-    "slides": {"service": "slides", "version": "v1"}
+    "slides": {"service": "slides", "version": "v1"},
+    "tasks": {"service": "tasks", "version": "v1"}
 }
 
 
@@ -72,6 +74,10 @@ SCOPE_GROUPS = {
     # Slides scopes
     "slides": SLIDES_SCOPE,
     "slides_read": SLIDES_READONLY_SCOPE,
+
+    # Tasks scopes
+    "tasks": TASKS_SCOPE,
+    "tasks_read": TASKS_READONLY_SCOPE,
 }
 
 # Service cache: {cache_key: (service, cached_time, user_email)}

core/server.py

@@ -49,6 +49,9 @@ from auth.scopes import (
     SLIDES_SCOPE,
     SLIDES_READONLY_SCOPE,
     SLIDES_SCOPES,
+    TASKS_SCOPE,
+    TASKS_READONLY_SCOPE,
+    TASKS_SCOPES,
     SCOPES
 )
 

gtasks/__init__.py

@@ -0,0 +1,5 @@
+"""
+Google Tasks MCP Integration
+
+This module provides MCP tools for interacting with Google Tasks API.
+"""

gtasks/tasks_tools.py

@@ -0,0 +1,732 @@
+"""
+Google Tasks MCP Tools
+
+This module provides MCP tools for interacting with Google Tasks API.
+"""
+
+import logging
+import asyncio
+from typing import List, Optional, Dict, Any
+
+from mcp import types
+from googleapiclient.errors import HttpError
+
+from auth.service_decorator import require_google_service
+from core.server import server
+
+logger = logging.getLogger(__name__)
+
+
+@server.tool()
+@require_google_service("tasks", "tasks_read")
+async def list_task_lists(
+    service,
+    user_google_email: str,
+    max_results: Optional[int] = None,
+    page_token: Optional[str] = None
+) -> str:
+    """
+    List all task lists for the user.
+
+    Args:
+        user_google_email (str): The user's Google email address. Required.
+        max_results (Optional[int]): Maximum number of task lists to return (default: 1000, max: 1000).
+        page_token (Optional[str]): Token for pagination.
+
+    Returns:
+        str: List of task lists with their IDs, titles, and details.
+    """
+    logger.info(f"[list_task_lists] Invoked. Email: '{user_google_email}'")
+
+    try:
+        params = {}
+        if max_results is not None:
+            params["maxResults"] = max_results
+        if page_token:
+            params["pageToken"] = page_token
+
+        result = await asyncio.to_thread(
+            service.tasklists().list(**params).execute
+        )
+
+        task_lists = result.get("items", [])
+        next_page_token = result.get("nextPageToken")
+
+        if not task_lists:
+            return f"No task lists found for {user_google_email}."
+
+        response = f"Task Lists for {user_google_email}:\n"
+        for task_list in task_lists:
+            response += f"- {task_list['title']} (ID: {task_list['id']})\n"
+            response += f"  Updated: {task_list.get('updated', 'N/A')}\n"
+
+        if next_page_token:
+            response += f"\nNext page token: {next_page_token}"
+
+        logger.info(f"Found {len(task_lists)} task lists for {user_google_email}")
+        return response
+
+    except HttpError as error:
+        message = f"API error: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Tasks'."
+        logger.error(message, exc_info=True)
+        raise Exception(message)
+    except Exception as e:
+        message = f"Unexpected error: {e}."
+        logger.exception(message)
+        raise Exception(message)
+
+
+@server.tool()
+@require_google_service("tasks", "tasks_read")
+async def get_task_list(
+    service,
+    user_google_email: str,
+    task_list_id: str
+) -> str:
+    """
+    Get details of a specific task list.
+
+    Args:
+        user_google_email (str): The user's Google email address. Required.
+        task_list_id (str): The ID of the task list to retrieve.
+
+    Returns:
+        str: Task list details including title, ID, and last updated time.
+    """
+    logger.info(f"[get_task_list] Invoked. Email: '{user_google_email}', Task List ID: {task_list_id}")
+
+    try:
+        task_list = await asyncio.to_thread(
+            service.tasklists().get(tasklist=task_list_id).execute
+        )
+
+        response = f"""Task List Details for {user_google_email}:
+- Title: {task_list['title']}
+- ID: {task_list['id']}
+- Updated: {task_list.get('updated', 'N/A')}
+- Self Link: {task_list.get('selfLink', 'N/A')}"""
+
+        logger.info(f"Retrieved task list '{task_list['title']}' for {user_google_email}")
+        return response
+
+    except HttpError as error:
+        message = f"API error: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Tasks'."
+        logger.error(message, exc_info=True)
+        raise Exception(message)
+    except Exception as e:
+        message = f"Unexpected error: {e}."
+        logger.exception(message)
+        raise Exception(message)
+
+
+@server.tool()
+@require_google_service("tasks", "tasks")
+async def create_task_list(
+    service,
+    user_google_email: str,
+    title: str
+) -> str:
+    """
+    Create a new task list.
+
+    Args:
+        user_google_email (str): The user's Google email address. Required.
+        title (str): The title of the new task list.
+
+    Returns:
+        str: Confirmation message with the new task list ID and details.
+    """
+    logger.info(f"[create_task_list] Invoked. Email: '{user_google_email}', Title: '{title}'")
+
+    try:
+        body = {
+            "title": title
+        }
+
+        result = await asyncio.to_thread(
+            service.tasklists().insert(body=body).execute
+        )
+
+        response = f"""Task List Created for {user_google_email}:
+- Title: {result['title']}
+- ID: {result['id']}
+- Created: {result.get('updated', 'N/A')}
+- Self Link: {result.get('selfLink', 'N/A')}"""
+
+        logger.info(f"Created task list '{title}' with ID {result['id']} for {user_google_email}")
+        return response
+
+    except HttpError as error:
+        message = f"API error: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Tasks'."
+        logger.error(message, exc_info=True)
+        raise Exception(message)
+    except Exception as e:
+        message = f"Unexpected error: {e}."
+        logger.exception(message)
+        raise Exception(message)
+
+
+@server.tool()
+@require_google_service("tasks", "tasks")
+async def update_task_list(
+    service,
+    user_google_email: str,
+    task_list_id: str,
+    title: str
+) -> str:
+    """
+    Update an existing task list.
+
+    Args:
+        user_google_email (str): The user's Google email address. Required.
+        task_list_id (str): The ID of the task list to update.
+        title (str): The new title for the task list.
+
+    Returns:
+        str: Confirmation message with updated task list details.
+    """
+    logger.info(f"[update_task_list] Invoked. Email: '{user_google_email}', Task List ID: {task_list_id}, New Title: '{title}'")
+
+    try:
+        body = {
+            "id": task_list_id,
+            "title": title
+        }
+
+        result = await asyncio.to_thread(
+            service.tasklists().update(tasklist=task_list_id, body=body).execute
+        )
+
+        response = f"""Task List Updated for {user_google_email}:
+- Title: {result['title']}
+- ID: {result['id']}
+- Updated: {result.get('updated', 'N/A')}"""
+
+        logger.info(f"Updated task list {task_list_id} with new title '{title}' for {user_google_email}")
+        return response
+
+    except HttpError as error:
+        message = f"API error: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Tasks'."
+        logger.error(message, exc_info=True)
+        raise Exception(message)
+    except Exception as e:
+        message = f"Unexpected error: {e}."
+        logger.exception(message)
+        raise Exception(message)
+
+
+@server.tool()
+@require_google_service("tasks", "tasks")
+async def delete_task_list(
+    service,
+    user_google_email: str,
+    task_list_id: str
+) -> str:
+    """
+    Delete a task list. Note: This will also delete all tasks in the list.
+
+    Args:
+        user_google_email (str): The user's Google email address. Required.
+        task_list_id (str): The ID of the task list to delete.
+
+    Returns:
+        str: Confirmation message.
+    """
+    logger.info(f"[delete_task_list] Invoked. Email: '{user_google_email}', Task List ID: {task_list_id}")
+
+    try:
+        await asyncio.to_thread(
+            service.tasklists().delete(tasklist=task_list_id).execute
+        )
+
+        response = f"Task list {task_list_id} has been deleted for {user_google_email}. All tasks in this list have also been deleted."
+
+        logger.info(f"Deleted task list {task_list_id} for {user_google_email}")
+        return response
+
+    except HttpError as error:
+        message = f"API error: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Tasks'."
+        logger.error(message, exc_info=True)
+        raise Exception(message)
+    except Exception as e:
+        message = f"Unexpected error: {e}."
+        logger.exception(message)
+        raise Exception(message)
+
+
+@server.tool()
+@require_google_service("tasks", "tasks_read")
+async def list_tasks(
+    service,
+    user_google_email: str,
+    task_list_id: str,
+    max_results: Optional[int] = None,
+    page_token: Optional[str] = None,
+    show_completed: Optional[bool] = None,
+    show_deleted: Optional[bool] = None,
+    show_hidden: Optional[bool] = None,
+    show_assigned: Optional[bool] = None,
+    completed_max: Optional[str] = None,
+    completed_min: Optional[str] = None,
+    due_max: Optional[str] = None,
+    due_min: Optional[str] = None,
+    updated_min: Optional[str] = None
+) -> str:
+    """
+    List all tasks in a specific task list.
+
+    Args:
+        user_google_email (str): The user's Google email address. Required.
+        task_list_id (str): The ID of the task list to retrieve tasks from.
+        max_results (Optional[int]): Maximum number of tasks to return (default: 20, max: 100).
+        page_token (Optional[str]): Token for pagination.
+        show_completed (Optional[bool]): Whether to include completed tasks (default: True).
+        show_deleted (Optional[bool]): Whether to include deleted tasks (default: False).
+        show_hidden (Optional[bool]): Whether to include hidden tasks (default: False).
+        show_assigned (Optional[bool]): Whether to include assigned tasks (default: False).
+        completed_max (Optional[str]): Upper bound for completion date (RFC 3339 timestamp).
+        completed_min (Optional[str]): Lower bound for completion date (RFC 3339 timestamp).
+        due_max (Optional[str]): Upper bound for due date (RFC 3339 timestamp).
+        due_min (Optional[str]): Lower bound for due date (RFC 3339 timestamp).
+        updated_min (Optional[str]): Lower bound for last modification time (RFC 3339 timestamp).
+
+    Returns:
+        str: List of tasks with their details.
+    """
+    logger.info(f"[list_tasks] Invoked. Email: '{user_google_email}', Task List ID: {task_list_id}")
+
+    try:
+        params = {"tasklist": task_list_id}
+        if max_results is not None:
+            params["maxResults"] = max_results
+        if page_token:
+            params["pageToken"] = page_token
+        if show_completed is not None:
+            params["showCompleted"] = show_completed
+        if show_deleted is not None:
+            params["showDeleted"] = show_deleted
+        if show_hidden is not None:
+            params["showHidden"] = show_hidden
+        if show_assigned is not None:
+            params["showAssigned"] = show_assigned
+        if completed_max:
+            params["completedMax"] = completed_max
+        if completed_min:
+            params["completedMin"] = completed_min
+        if due_max:
+            params["dueMax"] = due_max
+        if due_min:
+            params["dueMin"] = due_min
+        if updated_min:
+            params["updatedMin"] = updated_min
+
+        result = await asyncio.to_thread(
+            service.tasks().list(**params).execute
+        )
+
+        tasks = result.get("items", [])
+        next_page_token = result.get("nextPageToken")
+
+        if not tasks:
+            return f"No tasks found in task list {task_list_id} for {user_google_email}."
+
+        response = f"Tasks in list {task_list_id} for {user_google_email}:\n"
+        for task in tasks:
+            response += f"- {task.get('title', 'Untitled')} (ID: {task['id']})\n"
+            response += f"  Status: {task.get('status', 'N/A')}\n"
+            if task.get('due'):
+                response += f"  Due: {task['due']}\n"
+            if task.get('notes'):
+                response += f"  Notes: {task['notes'][:100]}{'...' if len(task['notes']) > 100 else ''}\n"
+            if task.get('completed'):
+                response += f"  Completed: {task['completed']}\n"
+            response += f"  Updated: {task.get('updated', 'N/A')}\n"
+            response += "\n"
+
+        if next_page_token:
+            response += f"Next page token: {next_page_token}"
+
+        logger.info(f"Found {len(tasks)} tasks in list {task_list_id} for {user_google_email}")
+        return response
+
+    except HttpError as error:
+        message = f"API error: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Tasks'."
+        logger.error(message, exc_info=True)
+        raise Exception(message)
+    except Exception as e:
+        message = f"Unexpected error: {e}."
+        logger.exception(message)
+        raise Exception(message)
+
+
+@server.tool()
+@require_google_service("tasks", "tasks_read")
+async def get_task(
+    service,
+    user_google_email: str,
+    task_list_id: str,
+    task_id: str
+) -> str:
+    """
+    Get details of a specific task.
+
+    Args:
+        user_google_email (str): The user's Google email address. Required.
+        task_list_id (str): The ID of the task list containing the task.
+        task_id (str): The ID of the task to retrieve.
+
+    Returns:
+        str: Task details including title, notes, status, due date, etc.
+    """
+    logger.info(f"[get_task] Invoked. Email: '{user_google_email}', Task List ID: {task_list_id}, Task ID: {task_id}")
+
+    try:
+        task = await asyncio.to_thread(
+            service.tasks().get(tasklist=task_list_id, task=task_id).execute
+        )
+
+        response = f"""Task Details for {user_google_email}:
+- Title: {task.get('title', 'Untitled')}
+- ID: {task['id']}
+- Status: {task.get('status', 'N/A')}
+- Updated: {task.get('updated', 'N/A')}"""
+
+        if task.get('due'):
+            response += f"\n- Due Date: {task['due']}"
+        if task.get('completed'):
+            response += f"\n- Completed: {task['completed']}"
+        if task.get('notes'):
+            response += f"\n- Notes: {task['notes']}"
+        if task.get('parent'):
+            response += f"\n- Parent Task ID: {task['parent']}"
+        if task.get('position'):
+            response += f"\n- Position: {task['position']}"
+        if task.get('selfLink'):
+            response += f"\n- Self Link: {task['selfLink']}"
+        if task.get('webViewLink'):
+            response += f"\n- Web View Link: {task['webViewLink']}"
+
+        logger.info(f"Retrieved task '{task.get('title', 'Untitled')}' for {user_google_email}")
+        return response
+
+    except HttpError as error:
+        message = f"API error: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Tasks'."
+        logger.error(message, exc_info=True)
+        raise Exception(message)
+    except Exception as e:
+        message = f"Unexpected error: {e}."
+        logger.exception(message)
+        raise Exception(message)
+
+
+@server.tool()
+@require_google_service("tasks", "tasks")
+async def create_task(
+    service,
+    user_google_email: str,
+    task_list_id: str,
+    title: str,
+    notes: Optional[str] = None,
+    due: Optional[str] = None,
+    parent: Optional[str] = None,
+    previous: Optional[str] = None
+) -> str:
+    """
+    Create a new task in a task list.
+
+    Args:
+        user_google_email (str): The user's Google email address. Required.
+        task_list_id (str): The ID of the task list to create the task in.
+        title (str): The title of the task.
+        notes (Optional[str]): Notes/description for the task.
+        due (Optional[str]): Due date in RFC 3339 format (e.g., "2024-12-31T23:59:59Z").
+        parent (Optional[str]): Parent task ID (for subtasks).
+        previous (Optional[str]): Previous sibling task ID (for positioning).
+
+    Returns:
+        str: Confirmation message with the new task ID and details.
+    """
+    logger.info(f"[create_task] Invoked. Email: '{user_google_email}', Task List ID: {task_list_id}, Title: '{title}'")
+
+    try:
+        body = {
+            "title": title
+        }
+        if notes:
+            body["notes"] = notes
+        if due:
+            body["due"] = due
+
+        params = {"tasklist": task_list_id, "body": body}
+        if parent:
+            params["parent"] = parent
+        if previous:
+            params["previous"] = previous
+
+        result = await asyncio.to_thread(
+            service.tasks().insert(**params).execute
+        )
+
+        response = f"""Task Created for {user_google_email}:
+- Title: {result['title']}
+- ID: {result['id']}
+- Status: {result.get('status', 'N/A')}
+- Updated: {result.get('updated', 'N/A')}"""
+
+        if result.get('due'):
+            response += f"\n- Due Date: {result['due']}"
+        if result.get('notes'):
+            response += f"\n- Notes: {result['notes']}"
+        if result.get('webViewLink'):
+            response += f"\n- Web View Link: {result['webViewLink']}"
+
+        logger.info(f"Created task '{title}' with ID {result['id']} for {user_google_email}")
+        return response
+
+    except HttpError as error:
+        message = f"API error: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Tasks'."
+        logger.error(message, exc_info=True)
+        raise Exception(message)
+    except Exception as e:
+        message = f"Unexpected error: {e}."
+        logger.exception(message)
+        raise Exception(message)
+
+
+@server.tool()
+@require_google_service("tasks", "tasks")
+async def update_task(
+    service,
+    user_google_email: str,
+    task_list_id: str,
+    task_id: str,
+    title: Optional[str] = None,
+    notes: Optional[str] = None,
+    status: Optional[str] = None,
+    due: Optional[str] = None
+) -> str:
+    """
+    Update an existing task.
+
+    Args:
+        user_google_email (str): The user's Google email address. Required.
+        task_list_id (str): The ID of the task list containing the task.
+        task_id (str): The ID of the task to update.
+        title (Optional[str]): New title for the task.
+        notes (Optional[str]): New notes/description for the task.
+        status (Optional[str]): New status ("needsAction" or "completed").
+        due (Optional[str]): New due date in RFC 3339 format.
+
+    Returns:
+        str: Confirmation message with updated task details.
+    """
+    logger.info(f"[update_task] Invoked. Email: '{user_google_email}', Task List ID: {task_list_id}, Task ID: {task_id}")
+
+    try:
+        # First get the current task to build the update body
+        current_task = await asyncio.to_thread(
+            service.tasks().get(tasklist=task_list_id, task=task_id).execute
+        )
+
+        body = {
+            "id": task_id,
+            "title": title if title is not None else current_task.get("title", ""),
+            "status": status if status is not None else current_task.get("status", "needsAction")
+        }
+
+        if notes is not None:
+            body["notes"] = notes
+        elif current_task.get("notes"):
+            body["notes"] = current_task["notes"]
+
+        if due is not None:
+            body["due"] = due
+        elif current_task.get("due"):
+            body["due"] = current_task["due"]
+
+        result = await asyncio.to_thread(
+            service.tasks().update(tasklist=task_list_id, task=task_id, body=body).execute
+        )
+
+        response = f"""Task Updated for {user_google_email}:
+- Title: {result['title']}
+- ID: {result['id']}
+- Status: {result.get('status', 'N/A')}
+- Updated: {result.get('updated', 'N/A')}"""
+
+        if result.get('due'):
+            response += f"\n- Due Date: {result['due']}"
+        if result.get('notes'):
+            response += f"\n- Notes: {result['notes']}"
+        if result.get('completed'):
+            response += f"\n- Completed: {result['completed']}"
+
+        logger.info(f"Updated task {task_id} for {user_google_email}")
+        return response
+
+    except HttpError as error:
+        message = f"API error: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Tasks'."
+        logger.error(message, exc_info=True)
+        raise Exception(message)
+    except Exception as e:
+        message = f"Unexpected error: {e}."
+        logger.exception(message)
+        raise Exception(message)
+
+
+@server.tool()
+@require_google_service("tasks", "tasks")
+async def delete_task(
+    service,
+    user_google_email: str,
+    task_list_id: str,
+    task_id: str
+) -> str:
+    """
+    Delete a task from a task list.
+
+    Args:
+        user_google_email (str): The user's Google email address. Required.
+        task_list_id (str): The ID of the task list containing the task.
+        task_id (str): The ID of the task to delete.
+
+    Returns:
+        str: Confirmation message.
+    """
+    logger.info(f"[delete_task] Invoked. Email: '{user_google_email}', Task List ID: {task_list_id}, Task ID: {task_id}")
+
+    try:
+        await asyncio.to_thread(
+            service.tasks().delete(tasklist=task_list_id, task=task_id).execute
+        )
+
+        response = f"Task {task_id} has been deleted from task list {task_list_id} for {user_google_email}."
+
+        logger.info(f"Deleted task {task_id} for {user_google_email}")
+        return response
+
+    except HttpError as error:
+        message = f"API error: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Tasks'."
+        logger.error(message, exc_info=True)
+        raise Exception(message)
+    except Exception as e:
+        message = f"Unexpected error: {e}."
+        logger.exception(message)
+        raise Exception(message)
+
+
+@server.tool()
+@require_google_service("tasks", "tasks")
+async def move_task(
+    service,
+    user_google_email: str,
+    task_list_id: str,
+    task_id: str,
+    parent: Optional[str] = None,
+    previous: Optional[str] = None,
+    destination_task_list: Optional[str] = None
+) -> str:
+    """
+    Move a task to a different position or parent within the same list, or to a different list.
+
+    Args:
+        user_google_email (str): The user's Google email address. Required.
+        task_list_id (str): The ID of the current task list containing the task.
+        task_id (str): The ID of the task to move.
+        parent (Optional[str]): New parent task ID (for making it a subtask).
+        previous (Optional[str]): Previous sibling task ID (for positioning).
+        destination_task_list (Optional[str]): Destination task list ID (for moving between lists).
+
+    Returns:
+        str: Confirmation message with updated task details.
+    """
+    logger.info(f"[move_task] Invoked. Email: '{user_google_email}', Task List ID: {task_list_id}, Task ID: {task_id}")
+
+    try:
+        params = {
+            "tasklist": task_list_id,
+            "task": task_id
+        }
+        if parent:
+            params["parent"] = parent
+        if previous:
+            params["previous"] = previous
+        if destination_task_list:
+            params["destinationTasklist"] = destination_task_list
+
+        result = await asyncio.to_thread(
+            service.tasks().move(**params).execute
+        )
+
+        response = f"""Task Moved for {user_google_email}:
+- Title: {result['title']}
+- ID: {result['id']}
+- Status: {result.get('status', 'N/A')}
+- Updated: {result.get('updated', 'N/A')}"""
+
+        if result.get('parent'):
+            response += f"\n- Parent Task ID: {result['parent']}"
+        if result.get('position'):
+            response += f"\n- Position: {result['position']}"
+
+        move_details = []
+        if destination_task_list:
+            move_details.append(f"moved to task list {destination_task_list}")
+        if parent:
+            move_details.append(f"made a subtask of {parent}")
+        if previous:
+            move_details.append(f"positioned after {previous}")
+
+        if move_details:
+            response += f"\n- Move Details: {', '.join(move_details)}"
+
+        logger.info(f"Moved task {task_id} for {user_google_email}")
+        return response
+
+    except HttpError as error:
+        message = f"API error: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Tasks'."
+        logger.error(message, exc_info=True)
+        raise Exception(message)
+    except Exception as e:
+        message = f"Unexpected error: {e}."
+        logger.exception(message)
+        raise Exception(message)
+
+
+@server.tool()
+@require_google_service("tasks", "tasks")
+async def clear_completed_tasks(
+    service,
+    user_google_email: str,
+    task_list_id: str
+) -> str:
+    """
+    Clear all completed tasks from a task list. The tasks will be marked as hidden.
+
+    Args:
+        user_google_email (str): The user's Google email address. Required.
+        task_list_id (str): The ID of the task list to clear completed tasks from.
+
+    Returns:
+        str: Confirmation message.
+    """
+    logger.info(f"[clear_completed_tasks] Invoked. Email: '{user_google_email}', Task List ID: {task_list_id}")
+
+    try:
+        await asyncio.to_thread(
+            service.tasks().clear(tasklist=task_list_id).execute
+        )
+
+        response = f"All completed tasks have been cleared from task list {task_list_id} for {user_google_email}. The tasks are now hidden and won't appear in default task list views."
+
+        logger.info(f"Cleared completed tasks from list {task_list_id} for {user_google_email}")
+        return response
+
+    except HttpError as error:
+        message = f"API error: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Tasks'."
+        logger.error(message, exc_info=True)
+        raise Exception(message)
+    except Exception as e:
+        message = f"Unexpected error: {e}."
+        logger.exception(message)
+        raise Exception(message)

main.py

@@ -40,7 +40,7 @@ def safe_print(text):
         # Running as MCP server, suppress output to avoid JSON parsing errors
         logger.debug(f"[MCP Server] {text}")
         return
-    
+
     try:
         print(text, file=sys.stderr)
     except UnicodeEncodeError:
@@ -56,7 +56,7 @@ def main():
     parser.add_argument('--single-user', action='store_true',
                         help='Run in single-user mode - bypass session mapping and use any credentials from the credentials directory')
     parser.add_argument('--tools', nargs='*',
-                        choices=['gmail', 'drive', 'calendar', 'docs', 'sheets', 'chat', 'forms', 'slides'],
+                        choices=['gmail', 'drive', 'calendar', 'docs', 'sheets', 'chat', 'forms', 'slides', 'tasks'],
                         help='Specify which tools to register. If not provided, all tools are registered.')
     parser.add_argument('--transport', choices=['stdio', 'streamable-http'], default='stdio',
                         help='Transport mode: stdio (default) or streamable-http')
@@ -91,7 +91,8 @@ def main():
         'sheets': lambda: __import__('gsheets.sheets_tools'),
         'chat': lambda: __import__('gchat.chat_tools'),
         'forms': lambda: __import__('gforms.forms_tools'),
-        'slides': lambda: __import__('gslides.slides_tools')
+        'slides': lambda: __import__('gslides.slides_tools'),
+        'tasks': lambda: __import__('gtasks.tasks_tools')
     }
 
     tool_icons = {
@@ -102,7 +103,8 @@ def main():
         'sheets': '📊',
         'chat': '💬',
         'forms': '📝',
-        'slides': '🖼️'
+        'slides': '🖼️',
+        'tasks': '✓'
     }
 
     # Import specified tools or all tools if none specified

{workspace_mcp-1.1.3.dist-info → workspace_mcp-1.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workspace-mcp
-Version: 1.1.3
+Version: 1.1.4
 Summary: Comprehensive, highly performant Google Workspace Streamable HTTP & SSE MCP Server for Calendar, Gmail, Docs, Sheets, Slides & Drive
 Author-email: Taylor Wilsdon <taylor@taylorwilsdon.com>
 License: MIT
@@ -53,7 +53,9 @@ Dynamic: license-file
 
 **This is the single most feature-complete Google Workspace MCP server**
 
-*Full natural language control over Google Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, and Chat through all MCP clients, AI assistants and developer tools*
+*Full natural language control over Google Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Tasks, and Chat through all MCP clients, AI assistants and developer tools.*
+
+###### Support for all free Google accounts (Gmail, Docs, Drive etc) & Google Workspace plans (Starter, Standard, Plus, Enterprise, Non Profit etc) with their expanded app options like Chat & Spaces.
 
 </div>
 
@@ -85,11 +87,11 @@ Dynamic: license-file
 > In this case, Sonnet 4 took a pass & a human (me) verified them 6/28/25.
 
 
-## 🌐 Overview
+## Overview
 
 A production-ready MCP server that integrates all major Google Workspace services with AI assistants. Built with FastMCP for optimal performance, featuring advanced authentication handling, service caching, and streamlined development patterns.
 
-## ✨ Features
+## Features
 
 - **🔐 Advanced OAuth 2.0**: Secure authentication with automatic token refresh, transport-aware callback handling, session management, and centralized scope management
 - **📅 Google Calendar**: Full calendar management with event CRUD operations
@@ -99,6 +101,7 @@ A production-ready MCP server that integrates all major Google Workspace service
 - **📊 Google Sheets**: Comprehensive spreadsheet management with flexible cell operations and comment management
 - **🖼️ Google Slides**: Presentation management with slide creation, updates, content manipulation, and comment management
 - **📝 Google Forms**: Form creation, retrieval, publish settings, and response management
+- **✓ Google Tasks**: Complete task and task list management with hierarchy, due dates, and status tracking
 - **💬 Google Chat**: Space management and messaging capabilities
 - **🔄 Multiple Transports**: HTTP with SSE fallback, OpenAPI compatibility via `mcpo`
 - **⚡ High Performance**: Service caching, thread-safe sessions, FastMCP integration
@@ -121,7 +124,7 @@ export GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret"
 uvx workspace-mcp
 
 # Start with specific tools only
-uvx workspace-mcp --tools gmail drive calendar
+uvx workspace-mcp --tools gmail drive calendar tasks
 
 # Start in HTTP mode for debugging
 uvx workspace-mcp --transport streamable-http
@@ -149,7 +152,7 @@ uv run main.py
 
 1. **Google Cloud Setup**:
    - Create OAuth 2.0 credentials (web application) in [Google Cloud Console](https://console.cloud.google.com/)
-   - Enable APIs: Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Chat
+   - Enable APIs: Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Tasks, Chat
    - Add redirect URI: `http://localhost:8000/oauth2callback`
    - Configure credentials using one of these methods:
 
@@ -201,7 +204,7 @@ uv run main.py --transport streamable-http
 uv run main.py --single-user
 
 # Selective tool registration (only register specific tools)
-uv run main.py --tools gmail drive calendar
+uv run main.py --tools gmail drive calendar tasks
 uv run main.py --tools sheets docs
 uv run main.py --single-user --tools gmail  # Can combine with other flags
 
@@ -210,7 +213,7 @@ docker build -t workspace-mcp .
 docker run -p 8000:8000 -v $(pwd):/app workspace-mcp --transport streamable-http
 ```
 
-**Available Tools for `--tools` flag**: `gmail`, `drive`, `calendar`, `docs`, `sheets`, `forms`, `chat`
+**Available Tools for `--tools` flag**: `gmail`, `drive`, `calendar`, `docs`, `sheets`, `forms`, `tasks`, `chat`
 
 ### Connect to Claude Desktop
 
@@ -254,7 +257,7 @@ After running the script, just restart Claude Desktop and you're ready to go.
 
 **Get Google OAuth Credentials** (if you don't have them):
 - Go to [Google Cloud Console](https://console.cloud.google.com/)
-- Create a new project and enable APIs: Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Chat
+- Create a new project and enable APIs: Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Tasks, Chat
 - Create OAuth 2.0 Client ID (Web application) with redirect URI: `http://localhost:8000/oauth2callback`
 
 **Development Installation (For Contributors)**:
@@ -392,6 +395,23 @@ When calling a tool:
 | `get_form_response` | Get individual form response details |
 | `list_form_responses` | List all responses to a form with pagination |
 
+### ✓ Google Tasks ([`tasks_tools.py`](gtasks/tasks_tools.py))
+
+| Tool | Description |
+|------|-------------|
+| `list_task_lists` | List all task lists with pagination support |
+| `get_task_list` | Retrieve details of a specific task list |
+| `create_task_list` | Create new task lists with custom titles |
+| `update_task_list` | Modify existing task list titles |
+| `delete_task_list` | Remove task lists and all contained tasks |
+| `list_tasks` | List tasks in a specific list with filtering options |
+| `get_task` | Retrieve detailed information about a specific task |
+| `create_task` | Create new tasks with title, notes, due dates, and hierarchy |
+| `update_task` | Modify task properties including title, notes, status, and due dates |
+| `delete_task` | Remove tasks from task lists |
+| `move_task` | Reposition tasks within lists or move between lists |
+| `clear_completed_tasks` | Hide all completed tasks from a list |
+
 ### 💬 Google Chat ([`chat_tools.py`](gchat/chat_tools.py))
 
 | Tool | Description |

{workspace_mcp-1.1.3.dist-info → workspace_mcp-1.1.4.dist-info}/RECORD

@@ -1,14 +1,14 @@
-main.py,sha256=2WLURMeCnoVws_OJOj2dm6yz7cegYJl5FqzYBFa2YOI,7513
+main.py,sha256=a4w_AcD_nSJo9697-75tZ3sU0tqOP1J8xTrXXD7qmns,7601
 auth/__init__.py,sha256=gPCU3GE-SLy91S3D3CbX-XfKBm6hteK_VSPKx7yjT5s,42
 auth/google_auth.py,sha256=JiGrHFpzhuxQgUNumZtAbyl8HTisDVdnvVFeSqpkCfg,32939
 auth/oauth_callback_server.py,sha256=igrur3fkZSY0bawufrH4AN9fMNpobUdAUp1BG7AQC6w,9341
 auth/oauth_responses.py,sha256=qbirSB4d7mBRKcJKqGLrJxRAPaLHqObf9t-VMAq6UKA,7020
-auth/scopes.py,sha256=kMRdFN0wLyipFkp7IitTHs-M6zhZD-oieVd7fylueBc,3320
-auth/service_decorator.py,sha256=h9bkG1O6U-p4_yT1KseBKJvueprKd4SVJe1Bj2VrdXA,15669
+auth/scopes.py,sha256=v091tidkMnhB0pPWOr0O08mU_s9yxSwVZkpVOyvlSwY,3550
+auth/service_decorator.py,sha256=8UfJnST6oi5Mci2YUdiIocn8--0oAEXm74VrGMroqzQ,15846
 core/__init__.py,sha256=AHVKdPl6v4lUFm2R-KuGuAgEmCyfxseMeLGtntMcqCs,43
 core/comments.py,sha256=vVfZYjH0kwqFyXcwvBx3m0Ko4WmfTJTkfD3dCQbucuc,11215
 core/context.py,sha256=zNgPXf9EO2EMs9sQkfKiywoy6sEOksVNgOrJMA_c30Y,768
-core/server.py,sha256=8A5_o6RCZ3hhsAiCszZhHiUJbVVrxJLspcvCiMmt27Q,9265
+core/server.py,sha256=KNAo43WTgzb6WSOyYE4Nixs5yLSg3NGqT6V2v3h3Wxo,9326
 core/utils.py,sha256=sUNPhM0xh3tqgyCZxTcoje37Et-pbNJTksybTatDyho,10127
 gcalendar/__init__.py,sha256=D5fSdAwbeomoaj7XAdxSnIy-NVKNkpExs67175bOtfc,46
 gcalendar/calendar_tools.py,sha256=SIiSJRxG3G9KsScow0pYwew600_PdtFqlOo-y2vXQRo,22144
@@ -26,9 +26,11 @@ gsheets/__init__.py,sha256=jFfhD52w_EOVw6N5guf_dIc9eP2khW_eS9UAPJg_K3k,446
 gsheets/sheets_tools.py,sha256=TVlJ-jcIvJ_sJt8xO4-sBWIshb8rabJhjTmZfzHIJsU,11898
 gslides/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gslides/slides_tools.py,sha256=wil3XRyUMzUbpBUMqis0CW5eRuwOrP0Lp7-6WbF4QVU,10117
-workspace_mcp-1.1.3.dist-info/licenses/LICENSE,sha256=bB8L7rIyRy5o-WHxGgvRuY8hUTzNu4h3DTkvyV8XFJo,1070
-workspace_mcp-1.1.3.dist-info/METADATA,sha256=Gi0UFOQxhtECNLOLcB3JufzpfKV3LPuB1rd3Bz016aE,20158
-workspace_mcp-1.1.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-workspace_mcp-1.1.3.dist-info/entry_points.txt,sha256=kPiEfOTuf-ptDM0Rf2OlyrFudGW7hCZGg4MCn2Foxs4,44
-workspace_mcp-1.1.3.dist-info/top_level.txt,sha256=Y8mAkTitLNE2zZEJ-DbqR9R7Cs1V1MMf-UploVdOvlw,73
-workspace_mcp-1.1.3.dist-info/RECORD,,
+gtasks/__init__.py,sha256=qwOWUzQbkYLSBrdhCqEkAWPH2lEOljk1mLtrlab9YZc,107
+gtasks/tasks_tools.py,sha256=Gy_j1VTeaa4HD2HQe0U1QjG3dQrkijtPNe0dUq5mAZQ,26021
+workspace_mcp-1.1.4.dist-info/licenses/LICENSE,sha256=bB8L7rIyRy5o-WHxGgvRuY8hUTzNu4h3DTkvyV8XFJo,1070
+workspace_mcp-1.1.4.dist-info/METADATA,sha256=9e72G7CXNSO56YIRgxtGYHW1gEttRlOMKVGjuPlkxvc,21435
+workspace_mcp-1.1.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+workspace_mcp-1.1.4.dist-info/entry_points.txt,sha256=kPiEfOTuf-ptDM0Rf2OlyrFudGW7hCZGg4MCn2Foxs4,44
+workspace_mcp-1.1.4.dist-info/top_level.txt,sha256=uAg7uV2mETWYRw5g80XtO1lhxVO1sY6_IihNdG_4n24,80
+workspace_mcp-1.1.4.dist-info/RECORD,,

{workspace_mcp-1.1.3.dist-info → workspace_mcp-1.1.4.dist-info}/top_level.txt

@@ -8,4 +8,5 @@ gforms
 gmail
 gsheets
 gslides
+gtasks
 main