MCP Google Workspace Server

Instructions

Implementation Reference

• src/mcp_google_suite/server.py:310-323 (handler)

  MCP tool handler for 'docs_create' that validates input and delegates to DocsService.create_document.

  async def _handle_docs_create(
      self, context: GoogleWorkspaceContext, arguments: dict
  ) -> Dict[str, Any]:
      """Handle docs create requests."""
      title = arguments.get("title")
      content = arguments.get("content")
  
      if not title:
          raise ValueError("Document title is required")
  
      logger.debug(f"Creating document - Title: {title}, Content length: {len(content or '')}")
      result = await context.docs.create_document(title=title, content=content)
      logger.debug(f"Document created - ID: {result.get('documentId')}")
      return result

• src/mcp_google_suite/server.py:85-96 (schema)

  Input schema definition for the 'docs_create' tool, specifying title as required and content as optional.

  types.Tool(
      name="docs_create",
      description="Create a new Google Doc",
      inputSchema={
          "type": "object",
          "properties": {
              "title": {"type": "string", "description": "Title of the document"},
              "content": {"type": "string", "description": "Initial content"},
          },
          "required": ["title"],
      },
  ),

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

  Dynamic registration of tool handlers into the internal registry by matching _handle_* methods to tool names.

  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:15-27 (helper)

  Core helper function in DocsService that creates a Google Doc via API and optionally inserts initial content.

  async def create_document(self, title: str, content: Optional[str] = None) -> Dict[str, Any]:
      """Create a new Google Doc with optional initial content."""
      try:
          service = await self.get_service()
          doc = await asyncio.to_thread(service.documents().create(body={"title": title}).execute)
  
          if content:
              await self.update_document_content(doc["documentId"], content)
  
          return {"success": True, "document": doc}
      except HttpError as error:
          return {"success": False, **self.handle_error(error)}