MCP server for LogSeq

Instructions

Implementation Reference

• src/mcp_logseq/tools.py:25-64 (handler)

  The CreatePageToolHandler class defines the 'create_page' tool handler, including its schema, description, and execution logic. It validates inputs, creates a LogSeq API client, calls create_page on it, and returns success message.
  class CreatePageToolHandler(ToolHandler): def __init__(self): super().__init__("create_page") def get_tool_description(self): return Tool( name=self.name, description="Create a new page in LogSeq.", inputSchema={ "type": "object", "properties": { "title": { "type": "string", "description": "Title of the new page" }, "content": { "type": "string", "description": "Content of the new page" } }, "required": ["title", "content"] } ) def run_tool(self, args: dict) -> list[TextContent]: if "title" not in args or "content" not in args: raise RuntimeError("title and content arguments required") try: api = logseq.LogSeq(api_key=api_key) api.create_page(args["title"], args["content"]) return [TextContent( type="text", text=f"Successfully created page '{args['title']}'" )] except Exception as e: logger.error(f"Failed to create page: {str(e)}") raise
• src/mcp_logseq/server.py:75-75 (registration)

  Registration of the CreatePageToolHandler instance in the MCP server using add_tool_handler.
  add_tool_handler(tools.CreatePageToolHandler())
• src/mcp_logseq/tools.py:30-47 (schema)

  Input schema definition for the create_page tool, specifying title and content as required string properties.
  return Tool( name=self.name, description="Create a new page in LogSeq.", inputSchema={ "type": "object", "properties": { "title": { "type": "string", "description": "Title of the new page" }, "content": { "type": "string", "description": "Content of the new page" } }, "required": ["title", "content"] } )
• src/mcp_logseq/logseq.py:31-70 (helper)

  The LogSeq client's create_page method that handles the actual API calls to Logseq.Editor.createPage and optionally appendBlockInPage to create the page with content.
  def create_page(self, title: str, content: str = "") -> Any: """Create a new LogSeq page with specified title and content.""" url = self.get_base_url() logger.info(f"Creating page '{title}'") try: # Step 1: Create the page response = requests.post( url, headers=self._get_headers(), json={ "method": "logseq.Editor.createPage", "args": [title, {}, {"createFirstBlock": True}] }, verify=self.verify_ssl, timeout=self.timeout ) response.raise_for_status() page_result = response.json() # Step 2: Add content if provided if content and content.strip(): response = requests.post( url, headers=self._get_headers(), json={ "method": "logseq.Editor.appendBlockInPage", "args": [title, content] }, verify=self.verify_ssl, timeout=self.timeout ) response.raise_for_status() return page_result except Exception as e: logger.error(f"Error creating page: {str(e)}") raise