Logseq MCP Tools

Instructions

Creates a new page in the Logseq graph.

For journal pages, use the format "mmm dth, yyyy" (e.g., "Apr 4th, 2025").
Logseq automatically sets "journal?": true and "journalDay": YYYYMMDD.

Args:
    name: The name of the new page.
    properties: Optional properties to set on the new page.
    
Returns:
    Information about the created page.

Implementation Reference

• src/logseq_mcp/tools/pages.py:39-54 (handler)

  The primary MCP tool handler for 'create_page', decorated with @mcp.tool(). Delegates to LogseqAPIClient.create_page().

  @mcp.tool()
  def create_page(name: str, properties: Optional[Dict] = None) -> Dict:
      """
      Creates a new page in the Logseq graph.
      
      For journal pages, use the format "mmm dth, yyyy" (e.g., "Apr 4th, 2025").
      Logseq automatically sets "journal?": true and "journalDay": YYYYMMDD.
      
      Args:
          name: The name of the new page.
          properties: Optional properties to set on the new page.
          
      Returns:
          Information about the created page.
      """
      return logseq_client.create_page(name, properties)

• src/logseq_mcp/client/logseq_client.py:107-115 (helper)

  Underlying helper method in LogseqAPIClient that calls the Logseq API endpoint 'logseq.Editor.createPage'.

  def create_page(self, page_name: str, properties: Optional[Dict] = None) -> Dict:
      """Create a new page"""
      params = [page_name]
      if properties:
          params.append(properties)
      response = self.call_api("logseq.Editor.createPage", params)
      if isinstance(response, dict) and "result" in response:
          return response.get("result")
      return response

• src/logseq_mcp/tools/__init__.py:1-7 (registration)

  Re-exports the create_page tool function for use in other modules, facilitating its availability for MCP registration.

  from .pages import get_all_pages, get_page, create_page, delete_page, get_page_linked_references
  from .blocks import get_page_blocks, get_block, create_block, update_block, remove_block, insert_block, move_block, search_blocks
  
  __all__ = [
      "get_all_pages", 
      "get_page", 
      "create_page",

• src/logseq_mcp/__init__.py:3-13 (registration)

  Imports and exports the create_page tool as part of the package __all__, making it available when the package is imported before running the MCP server.

  from .tools import (
      get_all_pages, 
      get_page, 
      create_page,
      get_page_blocks,
      get_block,
      create_block, 
      update_block,
      search_blocks,
      get_page_linked_references,
  )