Logseq MCP Tools

Instructions

Gets a specific page from the Logseq graph by name.

For journal pages, use the format "mmm dth, yyyy" (e.g., "Apr 4th, 2025").
Journal pages have specific attributes:
- "journal?": true - Indicates this is a journal page
- "journalDay": YYYYMMDD - The date in numeric format

Args:
    name: The name of the page to retrieve.
    
Returns:
    Information about the requested page, or None if not found.

Implementation Reference

• src/logseq_mcp/tools/pages.py:21-37 (handler)

  The MCP tool handler for the 'get_page' tool. Decorated with @mcp.tool(), it defines the input (name: str) and output (Optional[Dict]) schema via type hints and docstring, and implements the logic by delegating to the Logseq client.

  @mcp.tool()
  def get_page(name: str) -> Optional[Dict]:
      """
      Gets a specific page from the Logseq graph by name.
      
      For journal pages, use the format "mmm dth, yyyy" (e.g., "Apr 4th, 2025").
      Journal pages have specific attributes:
      - "journal?": true - Indicates this is a journal page
      - "journalDay": YYYYMMDD - The date in numeric format
      
      Args:
          name: The name of the page to retrieve.
          
      Returns:
          Information about the requested page, or None if not found.
      """
      return logseq_client.get_page(name)

• src/logseq_mcp/client/logseq_client.py:86-91 (helper)

  Helper method in LogseqAPIClient that performs the actual API call to retrieve the page from Logseq.

  def get_page(self, page_name: str) -> Optional[Dict]:
      """Get a page by name"""
      response = self.call_api("logseq.Editor.getPage", [page_name])
      if response is None:
          return None
      return response.get("result") if isinstance(response, dict) else response

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

  Exported in the package __init__.py for easy import of the tool function.

  get_page, 
  create_page,

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

  Imported and re-exported in tools/__init__.py.

  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",