docs_create
Generate and save a new Google Doc with a specified title and initial content using the MCP Google Workspace Server for streamlined document creation.
Instructions
Create a new Google Doc
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| content | No | Initial content | |
| title | Yes | Title of the document |
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}")
- 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)}