workspace-mcp 1.0.3__py3-none-any.whl → 1.0.5__py3-none-any.whl

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}"

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:
     """

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']

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']
+
+

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

main.py

@@ -35,9 +35,9 @@ except Exception as e:
 
 def safe_print(text):
     try:
-        print(text)
+        print(text, file=sys.stderr)
     except UnicodeEncodeError:
-        print(text.encode('ascii', errors='replace').decode())
+        print(text.encode('ascii', errors='replace').decode(), file=sys.stderr)
 
 def main():
     """
@@ -73,7 +73,7 @@ def main():
         safe_print(f"   🔐 OAuth Callback: {base_uri}:{port}/oauth2callback")
     safe_print(f"   👤 Mode: {'Single-user' if args.single_user else 'Multi-user'}")
     safe_print(f"   🐍 Python: {sys.version.split()[0]}")
-    print()
+    print(file=sys.stderr)
 
     # Import tool modules to register them with the MCP server via decorators
     tool_imports = {
@@ -104,29 +104,29 @@ def main():
     for tool in tools_to_import:
         tool_imports[tool]()
         safe_print(f"   {tool_icons[tool]} {tool.title()} - Google {tool.title()} API integration")
-    print()
+    print(file=sys.stderr)
 
     safe_print(f"📊 Configuration Summary:")
     safe_print(f"   🔧 Tools Enabled: {len(tools_to_import)}/{len(tool_imports)}")
     safe_print(f"   🔑 Auth Method: OAuth 2.0 with PKCE")
     safe_print(f"   📝 Log Level: {logging.getLogger().getEffectiveLevel()}")
-    print()
+    print(file=sys.stderr)
 
     # Set global single-user mode flag
     if args.single_user:
         os.environ['MCP_SINGLE_USER_MODE'] = '1'
         safe_print("🔐 Single-user mode enabled")
-        print()
+        print(file=sys.stderr)
 
     # Check credentials directory permissions before starting
     try:
         safe_print("🔍 Checking credentials directory permissions...")
         check_credentials_directory_permissions()
         safe_print("✅ Credentials directory permissions verified")
-        print()
+        print(file=sys.stderr)
     except (PermissionError, OSError) as e:
         safe_print(f"❌ Credentials directory permission check failed: {e}")
-        print("   Please ensure the service has write permissions to create/access the .credentials directory")
+        print("   Please ensure the service has write permissions to create/access the .credentials directory", file=sys.stderr)
         logger.error(f"Failed credentials directory permission check: {e}")
         sys.exit(1)
 
@@ -141,12 +141,12 @@ def main():
             # Start minimal OAuth callback server for stdio mode
             from auth.oauth_callback_server import ensure_oauth_callback_available
             if ensure_oauth_callback_available('stdio', port, base_uri):
-                print(f"   OAuth callback server started on {base_uri}:{port}/oauth2callback")
+                print(f"   OAuth callback server started on {base_uri}:{port}/oauth2callback", file=sys.stderr)
             else:
                 safe_print("   ⚠️  Warning: Failed to start OAuth callback server")
 
-        print("   Ready for MCP connections!")
-        print()
+        print("   Ready for MCP connections!", file=sys.stderr)
+        print(file=sys.stderr)
 
         if args.transport == 'streamable-http':
             # The server is already configured with port and server_url in core/server.py

{workspace_mcp-1.0.3.dist-info → workspace_mcp-1.0.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workspace-mcp
-Version: 1.0.3
+Version: 1.0.5
 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.dist-info → workspace_mcp-1.0.5.dist-info}/RECORD

@@ -1,4 +1,4 @@
-main.py,sha256=Mv5jfggqQ5XqzetKhccD2OmeWFnhidSbgzyKppCfywo,7078
+main.py,sha256=u2V2l4wlYxP0MwSITukYxtha3HSdmNGHSllIv5z-WxA,7253
 auth/__init__.py,sha256=gPCU3GE-SLy91S3D3CbX-XfKBm6hteK_VSPKx7yjT5s,42
 auth/google_auth.py,sha256=2UBbQgGcUPdUFWDbzdFy60NJLQ3SI45GIASzuzO1Tew,30717
 auth/oauth_callback_server.py,sha256=igrur3fkZSY0bawufrH4AN9fMNpobUdAUp1BG7AQC6w,9341
@@ -6,15 +6,16 @@ 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
 core/__init__.py,sha256=AHVKdPl6v4lUFm2R-KuGuAgEmCyfxseMeLGtntMcqCs,43
+core/comments.py,sha256=n-S84v5N5x3LbL45vGUerERhNPYvuSlugpOboYtPGgw,11328
 core/context.py,sha256=zNgPXf9EO2EMs9sQkfKiywoy6sEOksVNgOrJMA_c30Y,768
-core/server.py,sha256=fBPGMy9axIUOppsRFB31rlkaxEV32JRvaw2ZN_UZ9ms,9188
+core/server.py,sha256=8A5_o6RCZ3hhsAiCszZhHiUJbVVrxJLspcvCiMmt27Q,9265
 core/utils.py,sha256=2t5wbLtSLodxNKNAZb-jmR8Zg6mm-Rady-LpnXCP-1g,10297
 gcalendar/__init__.py,sha256=D5fSdAwbeomoaj7XAdxSnIy-NVKNkpExs67175bOtfc,46
 gcalendar/calendar_tools.py,sha256=SIiSJRxG3G9KsScow0pYwew600_PdtFqlOo-y2vXQRo,22144
 gchat/__init__.py,sha256=XBjH4SbtULfZHgFCxk3moel5XqG599HCgZWl_veIncg,88
 gchat/chat_tools.py,sha256=cIeXBBxWkFCdQNJ23BkX8IoDho6J8ZcfLsPjctUWyfA,7274
 gdocs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gdocs/docs_tools.py,sha256=AN9yG0c2AWCTd3bjc9guYBaOOF_PS_c_xKV6UMXclvU,13555
+gdocs/docs_tools.py,sha256=gWPBXf2M_ucP9LasAW0JAlCFAwixlcbAFDGS62xspZ4,8482
 gdrive/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gdrive/drive_tools.py,sha256=l-6IpHTstRMKIY2CU4DFTTNfEQ5rVbafgwo8BrbJ9Bk,15257
 gforms/__init__.py,sha256=pL91XixrEp9YjpM-AYwONIEfeCP2OumkEG0Io5V4boE,37
@@ -22,12 +23,12 @@ gforms/forms_tools.py,sha256=reJF3qw9WwW6-aCOkS2x5jVBvdRx4Za8onEZBC57RXk,9663
 gmail/__init__.py,sha256=l8PZ4_7Oet6ZE7tVu9oQ3-BaRAmI4YzAO86kf9uu6pU,60
 gmail/gmail_tools.py,sha256=UIcws__Akw0kxbasc9fYH7rkzDw_7L-LJU1LQU_p-sA,24754
 gsheets/__init__.py,sha256=jFfhD52w_EOVw6N5guf_dIc9eP2khW_eS9UAPJg_K3k,446
-gsheets/sheets_tools.py,sha256=ctUvaA-3I-iGwCCHOk9Bloh5P7XQDqxBnFAxFTqCTPc,11466
+gsheets/sheets_tools.py,sha256=TVlJ-jcIvJ_sJt8xO4-sBWIshb8rabJhjTmZfzHIJsU,11898
 gslides/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gslides/slides_tools.py,sha256=FyFbpUxfbaueyN4lbRk5WeoxK7NWbLDTBCiyDPtPFgM,9426
-workspace_mcp-1.0.3.dist-info/licenses/LICENSE,sha256=bB8L7rIyRy5o-WHxGgvRuY8hUTzNu4h3DTkvyV8XFJo,1070
-workspace_mcp-1.0.3.dist-info/METADATA,sha256=Ix57WY-9KB0uDjyFNMWYh42CcEpJEmDtx9Xe3N-bIgY,18318
-workspace_mcp-1.0.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-workspace_mcp-1.0.3.dist-info/entry_points.txt,sha256=kPiEfOTuf-ptDM0Rf2OlyrFudGW7hCZGg4MCn2Foxs4,44
-workspace_mcp-1.0.3.dist-info/top_level.txt,sha256=Y8mAkTitLNE2zZEJ-DbqR9R7Cs1V1MMf-UploVdOvlw,73
-workspace_mcp-1.0.3.dist-info/RECORD,,
+gslides/slides_tools.py,sha256=wil3XRyUMzUbpBUMqis0CW5eRuwOrP0Lp7-6WbF4QVU,10117
+workspace_mcp-1.0.5.dist-info/licenses/LICENSE,sha256=bB8L7rIyRy5o-WHxGgvRuY8hUTzNu4h3DTkvyV8XFJo,1070
+workspace_mcp-1.0.5.dist-info/METADATA,sha256=I81V5KDQkJCvFm2zuAnZFqPgXAfvRWJKlFR56fYH4ek,19406
+workspace_mcp-1.0.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+workspace_mcp-1.0.5.dist-info/entry_points.txt,sha256=kPiEfOTuf-ptDM0Rf2OlyrFudGW7hCZGg4MCn2Foxs4,44
+workspace_mcp-1.0.5.dist-info/top_level.txt,sha256=Y8mAkTitLNE2zZEJ-DbqR9R7Cs1V1MMf-UploVdOvlw,73
+workspace_mcp-1.0.5.dist-info/RECORD,,