MCP server for LogSeq

Instructions

Implementation Reference

• src/mcp_logseq/tools.py:235-269 (handler)

  The run_tool method of DeletePageToolHandler executes the core logic of the delete_page tool by instantiating the LogSeq API client and calling its delete_page method with the provided page_name argument.
  def run_tool(self, args: dict) -> list[TextContent]: if "page_name" not in args: raise RuntimeError("page_name argument required") try: api = logseq.LogSeq(api_key=api_key) result = api.delete_page(args["page_name"]) # Build detailed success message page_name = args["page_name"] success_msg = f"✅ Successfully deleted page '{page_name}'" # Add any additional info from the API result if available if result and isinstance(result, dict): if result.get("success"): success_msg += f"\n📋 Status: {result.get('message', 'Deletion confirmed')}" success_msg += f"\n🗑️ Page '{page_name}' has been permanently removed from LogSeq" return [TextContent( type="text", text=success_msg )] except ValueError as e: # Handle validation errors (page not found) gracefully return [TextContent( type="text", text=f"❌ Error: {str(e)}" )] except Exception as e: logger.error(f"Failed to delete page: {str(e)}") return [TextContent( type="text", text=f"❌ Failed to delete page '{args['page_name']}': {str(e)}" )]
• src/mcp_logseq/tools.py:219-233 (schema)

  The input schema definition for the delete_page tool, specifying that a 'page_name' string is required.
  def get_tool_description(self): return Tool( name=self.name, description="Delete a page from LogSeq.", inputSchema={ "type": "object", "properties": { "page_name": { "type": "string", "description": "Name of the page to delete" } }, "required": ["page_name"] } )
• src/mcp_logseq/server.py:74-80 (registration)

  Registration of all tool handlers including DeletePageToolHandler in the MCP server setup.
  logger.info("Registering tool handlers...") add_tool_handler(tools.CreatePageToolHandler()) add_tool_handler(tools.ListPagesToolHandler()) add_tool_handler(tools.GetPageContentToolHandler()) add_tool_handler(tools.DeletePageToolHandler()) add_tool_handler(tools.UpdatePageToolHandler()) add_tool_handler(tools.SearchToolHandler())
• src/mcp_logseq/logseq.py:184-217 (helper)

  The LogSeq API helper method delete_page that performs the actual HTTP request to Logseq's deletePage RPC method after validating the page exists.
  def delete_page(self, page_name: str) -> Any: """Delete a LogSeq page by name.""" url = self.get_base_url() logger.info(f"Deleting page '{page_name}'") try: # Pre-delete validation: verify page exists existing_pages = self.list_pages() page_names = [p.get("originalName") or p.get("name") for p in existing_pages if p.get("originalName") or p.get("name")] if page_name not in page_names: raise ValueError(f"Page '{page_name}' does not exist") response = requests.post( url, headers=self._get_headers(), json={ "method": "logseq.Editor.deletePage", "args": [page_name] }, verify=self.verify_ssl, timeout=self.timeout ) response.raise_for_status() result = response.json() logger.info(f"Successfully deleted page '{page_name}'") return result except ValueError: # Re-raise validation errors as-is raise except Exception as e: logger.error(f"Error deleting page '{page_name}': {str(e)}") raise