workspace-mcp 1.0.3__tar.gz → 1.0.4__tar.gz

{workspace_mcp-1.0.3 → workspace_mcp-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workspace-mcp
-Version: 1.0.3
+Version: 1.0.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
@@ -76,20 +76,14 @@ Dynamic: license-file
 
 ---
 
-## AI-Enhanced Documentation
+### A quick plug for AI-Enhanced Docs
 
 > **This README was crafted with AI assistance, and here's why that matters**
 > 
-> When people dismiss documentation as "AI-generated," they're missing the bigger picture
+> As a solo developer building open source tools that may only ever serve my own needs, comprehensive documentation often wouldn't happen without AI help. Using agentic dev tools like **Roo** & **Claude Code** that understand the entire codebase, AI doesn't just regurgitate generic content - it extracts real implementation details and creates accurate, specific documentation.
+>
+> In this case, Sonnet 4 took a pass & a human (me) verified them 6/28/25.
 
-As a solo developer building open source tools that may only ever serve my own needs, comprehensive documentation often wouldn't happen without AI help. When done right—using agents like **Roo** or **Claude Code** that understand the entire codebase, AI doesn't just regurgitate generic content - it extracts real implementation details and creates accurate, specific documentation.
-
-**The alternative? No docs at all.** 
-
-I hope the community can appreciate these tools for what they enable: solo developers maintaining professional documentation standards while focusing on building great software.
-
----
-*This documentation was enhanced by AI with full codebase context. The result? You're reading docs that otherwise might not exist.*
 
 ## 🌐 Overview
 
@@ -101,9 +95,9 @@ A production-ready MCP server that integrates all major Google Workspace service
 - **📅 Google Calendar**: Full calendar management with event CRUD operations
 - **📁 Google Drive**: File operations with native Microsoft Office format support (.docx, .xlsx)
 - **📧 Gmail**: Complete email management with search, send, and draft capabilities
-- **📄 Google Docs**: Document operations including content extraction and creation
-- **📊 Google Sheets**: Comprehensive spreadsheet management with flexible cell operations
-- **🖼️ Google Slides**: Presentation management with slide creation, updates, and content manipulation
+- **📄 Google Docs**: Document operations including content extraction, creation, and comment management
+- **📊 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 Chat**: Space management and messaging capabilities
 - **🔄 Multiple Transports**: HTTP with SSE fallback, OpenAPI compatibility via `mcpo`
@@ -185,12 +179,14 @@ uv run main.py
 2. **Environment**:
    ```bash
    export OAUTHLIB_INSECURE_TRANSPORT=1  # Development only
+   export USER_GOOGLE_EMAIL=your.email@gmail.com  # Optional: Default email for auth - use this for single user setups and you won't need to set your email in system prompt for magic auth
    ```
 
 3. **Server Configuration**:
    The server's base URL and port can be customized using environment variables:
    - `WORKSPACE_MCP_BASE_URI`: Sets the base URI for the server (default: http://localhost). This affects the server_url used for Gemini native function calling and the OAUTH_REDIRECT_URI.
    - `WORKSPACE_MCP_PORT`: Sets the port the server listens on (default: 8000). This affects the server_url, port, and OAUTH_REDIRECT_URI.
+   - `USER_GOOGLE_EMAIL`: Optional default email for authentication flows. If set, the LLM won't need to specify your email when calling `start_google_auth`.
 
 ### Start the Server
 
@@ -338,6 +334,10 @@ When calling a tool:
 | `get_doc_content` | Extract document text |
 | `list_docs_in_folder` | List docs in folder |
 | `create_doc` | Create new documents |
+| `read_doc_comments` | Read all comments and replies |
+| `create_doc_comment` | Create new comments |
+| `reply_to_comment` | Reply to existing comments |
+| `resolve_comment` | Resolve comments |
 
 ### 📊 Google Sheets ([`sheets_tools.py`](gsheets/sheets_tools.py))
 
@@ -349,6 +349,24 @@ When calling a tool:
 | `modify_sheet_values` | Write/update/clear cells |
 | `create_spreadsheet` | Create new spreadsheets |
 | `create_sheet` | Add sheets to existing files |
+| `read_sheet_comments` | Read all comments and replies |
+| `create_sheet_comment` | Create new comments |
+| `reply_to_sheet_comment` | Reply to existing comments |
+| `resolve_sheet_comment` | Resolve comments |
+
+### 🖼️ Google Slides ([`slides_tools.py`](gslides/slides_tools.py))
+
+| Tool | Description |
+|------|-------------|
+| `create_presentation` | Create new presentations |
+| `get_presentation` | Retrieve presentation details |
+| `batch_update_presentation` | Apply multiple updates at once |
+| `get_page` | Get specific slide information |
+| `get_page_thumbnail` | Generate slide thumbnails |
+| `read_presentation_comments` | Read all comments and replies |
+| `create_presentation_comment` | Create new comments |
+| `reply_to_presentation_comment` | Reply to existing comments |
+| `resolve_presentation_comment` | Resolve comments |
 
 ### 📝 Google Forms ([`forms_tools.py`](gforms/forms_tools.py))
 

{workspace_mcp-1.0.3 → workspace_mcp-1.0.4}/README.md

@@ -34,20 +34,14 @@
 
 ---
 
-## AI-Enhanced Documentation
+### A quick plug for AI-Enhanced Docs
 
 > **This README was crafted with AI assistance, and here's why that matters**
 > 
-> When people dismiss documentation as "AI-generated," they're missing the bigger picture
+> As a solo developer building open source tools that may only ever serve my own needs, comprehensive documentation often wouldn't happen without AI help. Using agentic dev tools like **Roo** & **Claude Code** that understand the entire codebase, AI doesn't just regurgitate generic content - it extracts real implementation details and creates accurate, specific documentation.
+>
+> In this case, Sonnet 4 took a pass & a human (me) verified them 6/28/25.
 
-As a solo developer building open source tools that may only ever serve my own needs, comprehensive documentation often wouldn't happen without AI help. When done right—using agents like **Roo** or **Claude Code** that understand the entire codebase, AI doesn't just regurgitate generic content - it extracts real implementation details and creates accurate, specific documentation.
-
-**The alternative? No docs at all.** 
-
-I hope the community can appreciate these tools for what they enable: solo developers maintaining professional documentation standards while focusing on building great software.
-
----
-*This documentation was enhanced by AI with full codebase context. The result? You're reading docs that otherwise might not exist.*
 
 ## 🌐 Overview
 
@@ -59,9 +53,9 @@ A production-ready MCP server that integrates all major Google Workspace service
 - **📅 Google Calendar**: Full calendar management with event CRUD operations
 - **📁 Google Drive**: File operations with native Microsoft Office format support (.docx, .xlsx)
 - **📧 Gmail**: Complete email management with search, send, and draft capabilities
-- **📄 Google Docs**: Document operations including content extraction and creation
-- **📊 Google Sheets**: Comprehensive spreadsheet management with flexible cell operations
-- **🖼️ Google Slides**: Presentation management with slide creation, updates, and content manipulation
+- **📄 Google Docs**: Document operations including content extraction, creation, and comment management
+- **📊 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 Chat**: Space management and messaging capabilities
 - **🔄 Multiple Transports**: HTTP with SSE fallback, OpenAPI compatibility via `mcpo`
@@ -143,12 +137,14 @@ uv run main.py
 2. **Environment**:
    ```bash
    export OAUTHLIB_INSECURE_TRANSPORT=1  # Development only
+   export USER_GOOGLE_EMAIL=your.email@gmail.com  # Optional: Default email for auth - use this for single user setups and you won't need to set your email in system prompt for magic auth
    ```
 
 3. **Server Configuration**:
    The server's base URL and port can be customized using environment variables:
    - `WORKSPACE_MCP_BASE_URI`: Sets the base URI for the server (default: http://localhost). This affects the server_url used for Gemini native function calling and the OAUTH_REDIRECT_URI.
    - `WORKSPACE_MCP_PORT`: Sets the port the server listens on (default: 8000). This affects the server_url, port, and OAUTH_REDIRECT_URI.
+   - `USER_GOOGLE_EMAIL`: Optional default email for authentication flows. If set, the LLM won't need to specify your email when calling `start_google_auth`.
 
 ### Start the Server
 
@@ -296,6 +292,10 @@ When calling a tool:
 | `get_doc_content` | Extract document text |
 | `list_docs_in_folder` | List docs in folder |
 | `create_doc` | Create new documents |
+| `read_doc_comments` | Read all comments and replies |
+| `create_doc_comment` | Create new comments |
+| `reply_to_comment` | Reply to existing comments |
+| `resolve_comment` | Resolve comments |
 
 ### 📊 Google Sheets ([`sheets_tools.py`](gsheets/sheets_tools.py))
 
@@ -307,6 +307,24 @@ When calling a tool:
 | `modify_sheet_values` | Write/update/clear cells |
 | `create_spreadsheet` | Create new spreadsheets |
 | `create_sheet` | Add sheets to existing files |
+| `read_sheet_comments` | Read all comments and replies |
+| `create_sheet_comment` | Create new comments |
+| `reply_to_sheet_comment` | Reply to existing comments |
+| `resolve_sheet_comment` | Resolve comments |
+
+### 🖼️ Google Slides ([`slides_tools.py`](gslides/slides_tools.py))
+
+| Tool | Description |
+|------|-------------|
+| `create_presentation` | Create new presentations |
+| `get_presentation` | Retrieve presentation details |
+| `batch_update_presentation` | Apply multiple updates at once |
+| `get_page` | Get specific slide information |
+| `get_page_thumbnail` | Generate slide thumbnails |
+| `read_presentation_comments` | Read all comments and replies |
+| `create_presentation_comment` | Create new comments |
+| `reply_to_presentation_comment` | Reply to existing comments |
+| `resolve_presentation_comment` | Resolve comments |
 
 ### 📝 Google Forms ([`forms_tools.py`](gforms/forms_tools.py))
 

workspace_mcp-1.0.4/core/comments.py

@@ -0,0 +1,257 @@
+"""
+Core Comments Module
+
+This module provides reusable comment management functions for Google Workspace applications.
+All Google Workspace apps (Docs, Sheets, Slides) use the Drive API for comment operations.
+"""
+
+import logging
+import asyncio
+from typing import Dict, Any
+
+from mcp import types
+from googleapiclient.errors import HttpError
+
+from auth.service_decorator import require_google_service
+from core.server import server
+from core.utils import handle_http_errors
+
+logger = logging.getLogger(__name__)
+
+
+def create_comment_tools(app_name: str, file_id_param: str):
+    """
+    Factory function to create comment management tools for a specific Google Workspace app.
+
+    Args:
+        app_name: Name of the app (e.g., "document", "spreadsheet", "presentation")
+        file_id_param: Parameter name for the file ID (e.g., "document_id", "spreadsheet_id", "presentation_id")
+
+    Returns:
+        Dict containing the four comment management functions with unique names
+    """
+
+    # Create unique function names based on the app type
+    read_func_name = f"read_{app_name}_comments"
+    create_func_name = f"create_{app_name}_comment"
+    reply_func_name = f"reply_to_{app_name}_comment"
+    resolve_func_name = f"resolve_{app_name}_comment"
+
+    # Create read comments function
+    if file_id_param == "document_id":
+        @server.tool()
+        @require_google_service("drive", "drive_read")
+        @handle_http_errors(read_func_name)
+        async def read_comments(service, user_google_email: str, document_id: str) -> str:
+            """Read all comments from a Google Slide, Sheet or Doc."""
+            return await _read_comments_impl(service, app_name, document_id)
+
+        @server.tool()
+        @require_google_service("drive", "drive_file")
+        @handle_http_errors(create_func_name)
+        async def create_comment(service, user_google_email: str, document_id: str, comment_content: str) -> str:
+            """Create a new comment on a Google Slide, Sheet or Doc."""
+            return await _create_comment_impl(service, app_name, document_id, comment_content)
+
+        @server.tool()
+        @require_google_service("drive", "drive_file")
+        @handle_http_errors(reply_func_name)
+        async def reply_to_comment(service, user_google_email: str, document_id: str, comment_id: str, reply_content: str) -> str:
+            """Reply to a specific comment in a Google Document."""
+            return await _reply_to_comment_impl(service, app_name, document_id, comment_id, reply_content)
+
+        @server.tool()
+        @require_google_service("drive", "drive_file")
+        @handle_http_errors(resolve_func_name)
+        async def resolve_comment(service, user_google_email: str, document_id: str, comment_id: str) -> str:
+            """Resolve a comment in a Google Slide, Sheet or Doc."""
+            return await _resolve_comment_impl(service, app_name, document_id, comment_id)
+
+    elif file_id_param == "spreadsheet_id":
+        @server.tool()
+        @require_google_service("drive", "drive_read")
+        @handle_http_errors(read_func_name)
+        async def read_comments(service, user_google_email: str, spreadsheet_id: str) -> str:
+            """Read all comments from a Google Slide, Sheet or Doc."""
+            return await _read_comments_impl(service, app_name, spreadsheet_id)
+
+        @server.tool()
+        @require_google_service("drive", "drive_file")
+        @handle_http_errors(create_func_name)
+        async def create_comment(service, user_google_email: str, spreadsheet_id: str, comment_content: str) -> str:
+            """Create a new comment on a Google Slide, Sheet or Doc."""
+            return await _create_comment_impl(service, app_name, spreadsheet_id, comment_content)
+
+        @server.tool()
+        @require_google_service("drive", "drive_file")
+        @handle_http_errors(reply_func_name)
+        async def reply_to_comment(service, user_google_email: str, spreadsheet_id: str, comment_id: str, reply_content: str) -> str:
+            """Reply to a specific comment in a Google Slide, Sheet or Doc."""
+            return await _reply_to_comment_impl(service, app_name, spreadsheet_id, comment_id, reply_content)
+
+        @server.tool()
+        @require_google_service("drive", "drive_file")
+        @handle_http_errors(resolve_func_name)
+        async def resolve_comment(service, user_google_email: str, spreadsheet_id: str, comment_id: str) -> str:
+            """Resolve a comment in a Google Slide, Sheet or Doc."""
+            return await _resolve_comment_impl(service, app_name, spreadsheet_id, comment_id)
+
+    elif file_id_param == "presentation_id":
+        @server.tool()
+        @require_google_service("drive", "drive_read")
+        @handle_http_errors(read_func_name)
+        async def read_comments(service, user_google_email: str, presentation_id: str) -> str:
+            """Read all comments from a Google Slide, Sheet or Doc."""
+            return await _read_comments_impl(service, app_name, presentation_id)
+
+        @server.tool()
+        @require_google_service("drive", "drive_file")
+        @handle_http_errors(create_func_name)
+        async def create_comment(service, user_google_email: str, presentation_id: str, comment_content: str) -> str:
+            """Create a new comment on a Google Slide, Sheet or Doc."""
+            return await _create_comment_impl(service, app_name, presentation_id, comment_content)
+
+        @server.tool()
+        @require_google_service("drive", "drive_file")
+        @handle_http_errors(reply_func_name)
+        async def reply_to_comment(service, user_google_email: str, presentation_id: str, comment_id: str, reply_content: str) -> str:
+            """Reply to a specific comment in a Google Slide, Sheet or Doc."""
+            return await _reply_to_comment_impl(service, app_name, presentation_id, comment_id, reply_content)
+
+        @server.tool()
+        @require_google_service("drive", "drive_file")
+        @handle_http_errors(resolve_func_name)
+        async def resolve_comment(service, user_google_email: str, presentation_id: str, comment_id: str) -> str:
+            """Resolve a comment in a Google Slide, Sheet or Doc."""
+            return await _resolve_comment_impl(service, app_name, presentation_id, comment_id)
+
+    # Set the proper function names for MCP registration
+    read_comments.__name__ = read_func_name
+    create_comment.__name__ = create_func_name
+    reply_to_comment.__name__ = reply_func_name
+    resolve_comment.__name__ = resolve_func_name
+
+    return {
+        'read_comments': read_comments,
+        'create_comment': create_comment,
+        'reply_to_comment': reply_to_comment,
+        'resolve_comment': resolve_comment
+    }
+
+
+async def _read_comments_impl(service, app_name: str, file_id: str) -> str:
+    """Implementation for reading comments from any Google Workspace file."""
+    logger.info(f"[read_{app_name}_comments] Reading comments for {app_name} {file_id}")
+
+    response = await asyncio.to_thread(
+        service.comments().list(
+            fileId=file_id,
+            fields="comments(id,content,author,createdTime,modifiedTime,resolved,replies(content,author,id,createdTime,modifiedTime))"
+        ).execute
+    )
+
+    comments = response.get('comments', [])
+
+    if not comments:
+        return f"No comments found in {app_name} {file_id}"
+
+    output = [f"Found {len(comments)} comments in {app_name} {file_id}:\\n"]
+
+    for comment in comments:
+        author = comment.get('author', {}).get('displayName', 'Unknown')
+        content = comment.get('content', '')
+        created = comment.get('createdTime', '')
+        resolved = comment.get('resolved', False)
+        comment_id = comment.get('id', '')
+        status = " [RESOLVED]" if resolved else ""
+
+        output.append(f"Comment ID: {comment_id}")
+        output.append(f"Author: {author}")
+        output.append(f"Created: {created}{status}")
+        output.append(f"Content: {content}")
+
+        # Add replies if any
+        replies = comment.get('replies', [])
+        if replies:
+            output.append(f"  Replies ({len(replies)}):")
+            for reply in replies:
+                reply_author = reply.get('author', {}).get('displayName', 'Unknown')
+                reply_content = reply.get('content', '')
+                reply_created = reply.get('createdTime', '')
+                reply_id = reply.get('id', '')
+                output.append(f"    Reply ID: {reply_id}")
+                output.append(f"    Author: {reply_author}")
+                output.append(f"    Created: {reply_created}")
+                output.append(f"    Content: {reply_content}")
+
+        output.append("")  # Empty line between comments
+
+    return "\\n".join(output)
+
+
+async def _create_comment_impl(service, app_name: str, file_id: str, comment_content: str) -> str:
+    """Implementation for creating a comment on any Google Workspace file."""
+    logger.info(f"[create_{app_name}_comment] Creating comment in {app_name} {file_id}")
+
+    body = {"content": comment_content}
+
+    comment = await asyncio.to_thread(
+        service.comments().create(
+            fileId=file_id,
+            body=body,
+            fields="id,content,author,createdTime,modifiedTime"
+        ).execute
+    )
+
+    comment_id = comment.get('id', '')
+    author = comment.get('author', {}).get('displayName', 'Unknown')
+    created = comment.get('createdTime', '')
+
+    return f"Comment created successfully!\\nComment ID: {comment_id}\\nAuthor: {author}\\nCreated: {created}\\nContent: {comment_content}"
+
+
+async def _reply_to_comment_impl(service, app_name: str, file_id: str, comment_id: str, reply_content: str) -> str:
+    """Implementation for replying to a comment on any Google Workspace file."""
+    logger.info(f"[reply_to_{app_name}_comment] Replying to comment {comment_id} in {app_name} {file_id}")
+
+    body = {'content': reply_content}
+
+    reply = await asyncio.to_thread(
+        service.replies().create(
+            fileId=file_id,
+            commentId=comment_id,
+            body=body,
+            fields="id,content,author,createdTime,modifiedTime"
+        ).execute
+    )
+
+    reply_id = reply.get('id', '')
+    author = reply.get('author', {}).get('displayName', 'Unknown')
+    created = reply.get('createdTime', '')
+
+    return f"Reply posted successfully!\\nReply ID: {reply_id}\\nAuthor: {author}\\nCreated: {created}\\nContent: {reply_content}"
+
+
+async def _resolve_comment_impl(service, app_name: str, file_id: str, comment_id: str) -> str:
+    """Implementation for resolving a comment on any Google Workspace file."""
+    logger.info(f"[resolve_{app_name}_comment] Resolving comment {comment_id} in {app_name} {file_id}")
+
+    body = {
+        "content": "This comment has been resolved.",
+        "action": "resolve"
+    }
+
+    reply = await asyncio.to_thread(
+        service.replies().create(
+            fileId=file_id,
+            commentId=comment_id,
+            body=body,
+            fields="id,content,author,createdTime,modifiedTime"
+        ).execute
+    )
+
+    reply_id = reply.get('id', '')
+    author = reply.get('author', {}).get('displayName', 'Unknown')
+    created = reply.get('createdTime', '')
+
+    return f"Comment {comment_id} has been resolved successfully.\\nResolve reply ID: {reply_id}\\nAuthor: {author}\\nCreated: {created}"

{workspace_mcp-1.0.3 → workspace_mcp-1.0.4}/core/server.py

@@ -58,6 +58,7 @@ logger = logging.getLogger(__name__)
 
 WORKSPACE_MCP_PORT = int(os.getenv("PORT", os.getenv("WORKSPACE_MCP_PORT", 8000)))
 WORKSPACE_MCP_BASE_URI = os.getenv("WORKSPACE_MCP_BASE_URI", "http://localhost")
+USER_GOOGLE_EMAIL = os.getenv("USER_GOOGLE_EMAIL", None)
 
 # Transport mode detection (will be set by main.py)
 _current_transport_mode = "stdio"  # Default to stdio
@@ -155,8 +156,8 @@ async def oauth2_callback(request: Request) -> HTMLResponse:
 
 @server.tool()
 async def start_google_auth(
-    user_google_email: str,
     service_name: str,
+    user_google_email: str = USER_GOOGLE_EMAIL,
     mcp_session_id: Optional[str] = Header(None, alias="Mcp-Session-Id")
 ) -> str:
     """

{workspace_mcp-1.0.3 → workspace_mcp-1.0.4}/gdocs/docs_tools.py

@@ -16,6 +16,7 @@ from googleapiclient.http import MediaIoBaseDownload
 from auth.service_decorator import require_google_service, require_multiple_services
 from core.utils import extract_office_xml_text, handle_http_errors
 from core.server import server
+from core.comments import create_comment_tools
 
 logger = logging.getLogger(__name__)
 
@@ -216,179 +217,11 @@ async def create_doc(
     return msg
 
 
-@server.tool()
-@require_google_service("drive", "drive_read")
-@handle_http_errors("read_doc_comments")
-async def read_doc_comments(
-    service,
-    user_google_email: str,
-    document_id: str,
-) -> str:
-    """
-    Read all comments from a Google Doc.
-
-    Args:
-        document_id: The ID of the Google Document
-
-    Returns:
-        str: A formatted list of all comments and replies in the document.
-    """
-    logger.info(f"[read_doc_comments] Reading comments for document {document_id}")
-
-    response = await asyncio.to_thread(
-        service.comments().list(
-            fileId=document_id,
-            fields="comments(id,content,author,createdTime,modifiedTime,resolved,replies(content,author,id,createdTime,modifiedTime))"
-        ).execute
-    )
-    
-    comments = response.get('comments', [])
-    
-    if not comments:
-        return f"No comments found in document {document_id}"
-    
-    output = [f"Found {len(comments)} comments in document {document_id}:\n"]
-    
-    for comment in comments:
-        author = comment.get('author', {}).get('displayName', 'Unknown')
-        content = comment.get('content', '')
-        created = comment.get('createdTime', '')
-        resolved = comment.get('resolved', False)
-        comment_id = comment.get('id', '')
-        status = " [RESOLVED]" if resolved else ""
-        
-        output.append(f"Comment ID: {comment_id}")
-        output.append(f"Author: {author}")
-        output.append(f"Created: {created}{status}")
-        output.append(f"Content: {content}")
-        
-        # Add replies if any
-        replies = comment.get('replies', [])
-        if replies:
-            output.append(f"  Replies ({len(replies)}):")
-            for reply in replies:
-                reply_author = reply.get('author', {}).get('displayName', 'Unknown')
-                reply_content = reply.get('content', '')
-                reply_created = reply.get('createdTime', '')
-                reply_id = reply.get('id', '')
-                output.append(f"    Reply ID: {reply_id}")
-                output.append(f"    Author: {reply_author}")
-                output.append(f"    Created: {reply_created}")
-                output.append(f"    Content: {reply_content}")
-        
-        output.append("")  # Empty line between comments
-    
-    return "\n".join(output)
-
-
-@server.tool()
-@require_google_service("drive", "drive_file")
-@handle_http_errors("reply_to_comment")
-async def reply_to_comment(
-    service,
-    user_google_email: str,
-    document_id: str,
-    comment_id: str,
-    reply_content: str,
-) -> str:
-    """
-    Reply to a specific comment in a Google Doc.
-
-    Args:
-        document_id: The ID of the Google Document
-        comment_id: The ID of the comment to reply to
-        reply_content: The content of the reply
-
-    Returns:
-        str: Confirmation message with reply details.
-    """
-    logger.info(f"[reply_to_comment] Replying to comment {comment_id} in document {document_id}")
-
-    body = {'content': reply_content}
-    
-    reply = await asyncio.to_thread(
-        service.replies().create(
-            fileId=document_id,
-            commentId=comment_id,
-            body=body,
-            fields="id,content,author,createdTime,modifiedTime"
-        ).execute
-    )
-    
-    reply_id = reply.get('id', '')
-    author = reply.get('author', {}).get('displayName', 'Unknown')
-    created = reply.get('createdTime', '')
-    
-    return f"Reply posted successfully!\nReply ID: {reply_id}\nAuthor: {author}\nCreated: {created}\nContent: {reply_content}"
-
-
-@server.tool()
-@require_google_service("drive", "drive_file")
-@handle_http_errors("create_doc_comment")
-async def create_doc_comment(
-    service,
-    user_google_email: str,
-    document_id: str,
-    comment_content: str,
-) -> str:
-    """
-    Create a new comment on a Google Doc.
-
-    Args:
-        document_id: The ID of the Google Document
-        comment_content: The content of the comment
-
-    Returns:
-        str: Confirmation message with comment details.
-    """
-    logger.info(f"[create_doc_comment] Creating comment in document {document_id}")
-
-    body = {"content": comment_content}
-    
-    comment = await asyncio.to_thread(
-        service.comments().create(
-            fileId=document_id,
-            body=body,
-            fields="id,content,author,createdTime,modifiedTime"
-        ).execute
-    )
-    
-    comment_id = comment.get('id', '')
-    author = comment.get('author', {}).get('displayName', 'Unknown')
-    created = comment.get('createdTime', '')
-    
-    return f"Comment created successfully!\nComment ID: {comment_id}\nAuthor: {author}\nCreated: {created}\nContent: {comment_content}"
-
+# Create comment management tools for documents
+_comment_tools = create_comment_tools("document", "document_id")
 
-@server.tool()
-@require_google_service("drive", "drive_file")
-@handle_http_errors("resolve_comment")
-async def resolve_comment(
-    service,
-    user_google_email: str,
-    document_id: str,
-    comment_id: str,
-) -> str:
-    """
-    Resolve a comment in a Google Doc.
-
-    Args:
-        document_id: The ID of the Google Document
-        comment_id: The ID of the comment to resolve
-
-    Returns:
-        str: Confirmation message.
-    """
-    logger.info(f"[resolve_comment] Resolving comment {comment_id} in document {document_id}")
-
-    body = {"resolved": True}
-    
-    await asyncio.to_thread(
-        service.comments().update(
-            fileId=document_id,
-            commentId=comment_id,
-            body=body
-        ).execute
-    )
-    
-    return f"Comment {comment_id} has been resolved successfully."
+# Extract and register the functions
+read_doc_comments = _comment_tools['read_comments']
+create_doc_comment = _comment_tools['create_comment']
+reply_to_comment = _comment_tools['reply_to_comment']
+resolve_comment = _comment_tools['resolve_comment']

{workspace_mcp-1.0.3 → workspace_mcp-1.0.4}/gsheets/sheets_tools.py

@@ -14,6 +14,7 @@ from googleapiclient.errors import HttpError
 from auth.service_decorator import require_google_service
 from core.server import server
 from core.utils import handle_http_errors
+from core.comments import create_comment_tools
 
 # Configure module logger
 logger = logging.getLogger(__name__)
@@ -338,3 +339,13 @@ async def create_sheet(
     return text_output
 
 
+# Create comment management tools for sheets
+_comment_tools = create_comment_tools("spreadsheet", "spreadsheet_id")
+
+# Extract and register the functions
+read_sheet_comments = _comment_tools['read_comments']
+create_sheet_comment = _comment_tools['create_comment'] 
+reply_to_sheet_comment = _comment_tools['reply_to_comment']
+resolve_sheet_comment = _comment_tools['resolve_comment']
+
+

{workspace_mcp-1.0.3 → workspace_mcp-1.0.4}/gslides/slides_tools.py

@@ -14,6 +14,7 @@ from googleapiclient.errors import HttpError
 from auth.service_decorator import require_google_service
 from core.server import server
 from core.utils import handle_http_errors
+from core.comments import create_comment_tools
 
 logger = logging.getLogger(__name__)
 
@@ -269,4 +270,18 @@ async def get_page_thumbnail(
 You can view or download the thumbnail using the provided URL."""
     
     logger.info(f"Thumbnail generated successfully for {user_google_email}")
-    return confirmation_message
+    return confirmation_message
+
+
+# Create comment management tools for slides
+_comment_tools = create_comment_tools("presentation", "presentation_id")
+read_presentation_comments = _comment_tools['read_comments']
+create_presentation_comment = _comment_tools['create_comment']
+reply_to_presentation_comment = _comment_tools['reply_to_comment']
+resolve_presentation_comment = _comment_tools['resolve_comment']
+
+# Aliases for backwards compatibility and intuitive naming
+read_slide_comments = read_presentation_comments
+create_slide_comment = create_presentation_comment
+reply_to_slide_comment = reply_to_presentation_comment
+resolve_slide_comment = resolve_presentation_comment

{workspace_mcp-1.0.3 → workspace_mcp-1.0.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "workspace-mcp"
-version = "1.0.3"
+version = "1.0.4"
 description = "Comprehensive, highly performant Google Workspace Streamable HTTP & SSE MCP Server for Calendar, Gmail, Docs, Sheets, Slides & Drive"
 readme = "README.md"
 keywords = [ "mcp", "google", "workspace", "llm", "ai", "claude", "model", "context", "protocol", "server"]

{workspace_mcp-1.0.3 → workspace_mcp-1.0.4}/workspace_mcp.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workspace-mcp
-Version: 1.0.3
+Version: 1.0.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
@@ -76,20 +76,14 @@ Dynamic: license-file
 
 ---
 
-## AI-Enhanced Documentation
+### A quick plug for AI-Enhanced Docs
 
 > **This README was crafted with AI assistance, and here's why that matters**
 > 
-> When people dismiss documentation as "AI-generated," they're missing the bigger picture
+> As a solo developer building open source tools that may only ever serve my own needs, comprehensive documentation often wouldn't happen without AI help. Using agentic dev tools like **Roo** & **Claude Code** that understand the entire codebase, AI doesn't just regurgitate generic content - it extracts real implementation details and creates accurate, specific documentation.
+>
+> In this case, Sonnet 4 took a pass & a human (me) verified them 6/28/25.
 
-As a solo developer building open source tools that may only ever serve my own needs, comprehensive documentation often wouldn't happen without AI help. When done right—using agents like **Roo** or **Claude Code** that understand the entire codebase, AI doesn't just regurgitate generic content - it extracts real implementation details and creates accurate, specific documentation.
-
-**The alternative? No docs at all.** 
-
-I hope the community can appreciate these tools for what they enable: solo developers maintaining professional documentation standards while focusing on building great software.
-
----
-*This documentation was enhanced by AI with full codebase context. The result? You're reading docs that otherwise might not exist.*
 
 ## 🌐 Overview
 
@@ -101,9 +95,9 @@ A production-ready MCP server that integrates all major Google Workspace service
 - **📅 Google Calendar**: Full calendar management with event CRUD operations
 - **📁 Google Drive**: File operations with native Microsoft Office format support (.docx, .xlsx)
 - **📧 Gmail**: Complete email management with search, send, and draft capabilities
-- **📄 Google Docs**: Document operations including content extraction and creation
-- **📊 Google Sheets**: Comprehensive spreadsheet management with flexible cell operations
-- **🖼️ Google Slides**: Presentation management with slide creation, updates, and content manipulation
+- **📄 Google Docs**: Document operations including content extraction, creation, and comment management
+- **📊 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 Chat**: Space management and messaging capabilities
 - **🔄 Multiple Transports**: HTTP with SSE fallback, OpenAPI compatibility via `mcpo`
@@ -185,12 +179,14 @@ uv run main.py
 2. **Environment**:
    ```bash
    export OAUTHLIB_INSECURE_TRANSPORT=1  # Development only
+   export USER_GOOGLE_EMAIL=your.email@gmail.com  # Optional: Default email for auth - use this for single user setups and you won't need to set your email in system prompt for magic auth
    ```
 
 3. **Server Configuration**:
    The server's base URL and port can be customized using environment variables:
    - `WORKSPACE_MCP_BASE_URI`: Sets the base URI for the server (default: http://localhost). This affects the server_url used for Gemini native function calling and the OAUTH_REDIRECT_URI.
    - `WORKSPACE_MCP_PORT`: Sets the port the server listens on (default: 8000). This affects the server_url, port, and OAUTH_REDIRECT_URI.
+   - `USER_GOOGLE_EMAIL`: Optional default email for authentication flows. If set, the LLM won't need to specify your email when calling `start_google_auth`.
 
 ### Start the Server
 
@@ -338,6 +334,10 @@ When calling a tool:
 | `get_doc_content` | Extract document text |
 | `list_docs_in_folder` | List docs in folder |
 | `create_doc` | Create new documents |
+| `read_doc_comments` | Read all comments and replies |
+| `create_doc_comment` | Create new comments |
+| `reply_to_comment` | Reply to existing comments |
+| `resolve_comment` | Resolve comments |
 
 ### 📊 Google Sheets ([`sheets_tools.py`](gsheets/sheets_tools.py))
 
@@ -349,6 +349,24 @@ When calling a tool:
 | `modify_sheet_values` | Write/update/clear cells |
 | `create_spreadsheet` | Create new spreadsheets |
 | `create_sheet` | Add sheets to existing files |
+| `read_sheet_comments` | Read all comments and replies |
+| `create_sheet_comment` | Create new comments |
+| `reply_to_sheet_comment` | Reply to existing comments |
+| `resolve_sheet_comment` | Resolve comments |
+
+### 🖼️ Google Slides ([`slides_tools.py`](gslides/slides_tools.py))
+
+| Tool | Description |
+|------|-------------|
+| `create_presentation` | Create new presentations |
+| `get_presentation` | Retrieve presentation details |
+| `batch_update_presentation` | Apply multiple updates at once |
+| `get_page` | Get specific slide information |
+| `get_page_thumbnail` | Generate slide thumbnails |
+| `read_presentation_comments` | Read all comments and replies |
+| `create_presentation_comment` | Create new comments |
+| `reply_to_presentation_comment` | Reply to existing comments |
+| `resolve_presentation_comment` | Resolve comments |
 
 ### 📝 Google Forms ([`forms_tools.py`](gforms/forms_tools.py))
 

{workspace_mcp-1.0.3 → workspace_mcp-1.0.4}/workspace_mcp.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ auth/oauth_responses.py
 auth/scopes.py
 auth/service_decorator.py
 core/__init__.py
+core/comments.py
 core/context.py
 core/server.py
 core/utils.py