MCP Google Workspace Server

Instructions

Implementation Reference

• src/mcp_google_suite/server.py:325-337 (handler)

  The handler function that implements the core logic for the 'docs_get_content' tool. It validates the document_id input and calls the DocsService to retrieve the document content.

  async def _handle_docs_get_content(
      self, context: GoogleWorkspaceContext, arguments: dict
  ) -> Dict[str, Any]:
      """Handle docs get content requests."""
      document_id = arguments.get("document_id")
  
      if not document_id:
          raise ValueError("Document ID is required")
  
      logger.debug(f"Getting document content - ID: {document_id}")
      result = await context.docs.get_document_content(document_id=document_id)
      logger.debug("Document content retrieved successfully")
      return result

• src/mcp_google_suite/server.py:97-107 (schema)

  The input schema definition for the 'docs_get_content' tool, requiring a 'document_id' string parameter.

  types.Tool(
      name="docs_get_content",
      description="Get the contents of a Google Doc",
      inputSchema={
          "type": "object",
          "properties": {
              "document_id": {"type": "string", "description": "ID of the document"}
          },
          "required": ["document_id"],
      },
  ),

• src/mcp_google_suite/server.py:176-182 (registration)

  The registration logic that dynamically registers the 'docs_get_content' handler by looking for _handle_docs_get_content method.

  # Register tool handlers
  for tool in self._get_tools_list():
      handler_name = f"_handle_{tool.name}"
      if hasattr(self, handler_name):
          handler = getattr(self, handler_name)
          self._tool_registry[tool.name] = handler
          logger.debug(f"Registered handler for {tool.name}")

• src/mcp_google_suite/docs/service.py:28-37 (helper)

  Supporting method in DocsService that performs the actual API call to retrieve Google Doc contents (likely the target of the handler's delegation, despite minor name discrepancy).

  async def get_document(self, document_id: str) -> Dict[str, Any]:
      """Get the contents of a Google Doc."""
      try:
          service = await self.get_service()
          document = await asyncio.to_thread(
              service.documents().get(documentId=document_id).execute
          )
          return {"success": True, "document": document}
      except HttpError as error:
          return {"success": False, **self.handle_error(error)}