Logseq MCP Tools

Instructions

Creates a new block on a page in the Logseq graph.

IMPORTANT NOTES:
1. All blocks are automatically formatted as bullet points in Logseq UI
2. To create links to other pages, use double brackets: [[Page Name]]

When creating blocks on journal pages:
  - The block will inherit the "journal?" and "journalDay" attributes from the page
  - "journalDay" will be in YYYYMMDD format (e.g., 20250404 for April 4, 2025)

Args:
    page_name (str): The name of the page to create the block on.
    content (str): The content of the new block.
    properties (dict, optional): Properties to set on the new block.
    
Returns:
    dict: Information about the created block.

Implementation Reference

• src/logseq_mcp/tools/blocks.py:55-77 (handler)

  The MCP tool handler for 'create_block', decorated with @mcp.tool(). Defines input schema via type hints and docstring. Delegates to LogseqAPIClient.create_block.

  @mcp.tool()
  def create_block(page_name: str, content: str, properties: Optional[Dict] = None) -> Dict:
      """
      Creates a new block on a page in the Logseq graph.
      
      IMPORTANT NOTES:
      1. All blocks are automatically formatted as bullet points in Logseq UI
      2. To create links to other pages, use double brackets: [[Page Name]]
      
      When creating blocks on journal pages:
        - The block will inherit the "journal?" and "journalDay" attributes from the page
        - "journalDay" will be in YYYYMMDD format (e.g., 20250404 for April 4, 2025)
      
      Args:
          page_name (str): The name of the page to create the block on.
          content (str): The content of the new block.
          properties (dict, optional): Properties to set on the new block.
          
      Returns:
          dict: Information about the created block.
      """
      """Create a new block on the specified page."""
      return logseq_client.create_block(page_name, content, properties)

• src/logseq_mcp/client/logseq_client.py:117-125 (helper)

  Supporting utility in LogseqAPIClient that makes the actual API call to Logseq to append a new block to a page.

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

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

  Re-exports the create_block tool from blocks.py for convenient import in other modules.

  from .blocks import get_page_blocks, get_block, create_block, update_block, remove_block, insert_block, move_block, search_blocks

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

  Includes create_block in the public __all__ exports of the package.

  create_block,