Logseq MCP Tools

This project provides a set of Model Context Protocol (MCP) tools that enable AI agents to interact with your local Logseq instance.

Installation

1. Ensure you have Python 3.11+ installed
2. Clone this repository
3. Install dependencies:

   pip install -e .
   

Setup

1. Make sure your Logseq has the API enabled.

   • In Logseq, go to Settings > Advanced > Developer mode > Enable Developer mode
   • Then, go to Plugins > Turn on Logseq Developer Plugin
   • Also set an API token in the Advanced settings
   • Restart Logseq

2. Configure the MCP server in your Cursor MCP configuration file (typically at ~/.cursor/mcp.json):

   {
     "mcpServers": {
       "logseq": {
         "command": "/opt/homebrew/bin/uvx",
         "args": ["logseq-mcp"],
         "env": {
           "LOGSEQ_API_URL": "http://localhost:12315",
           "LOGSEQ_TOKEN": "your-token-here"
         }
       }
     }
   }
   

OR

3. Configure Claude Code to use the MCP server with:

claude mcp add

• Select scope
• Select Stdio
• LOGSEQ_API_URL=http://localhost:12315 LOGSEQ_TOKEN=your-token-here /opt/homebrew/bin/uvx logseq-mcp

Using with Cursor and Claude

Adding to Cursor’s MCP Tools

1. Configure the MCP server as shown above in the Setup section

2. Open Cursor and go to the MCP panel (sidebar)

3. The Logseq tool should appear in your list of available tools

Using with Claude

When using Claude in Cursor, you’ll need to inform it that you have Logseq tools available with a prompt similar to:

“You have access to Logseq tools that can help you interact with my Logseq graph. You can use functions like logseq.get_all_pages(), logseq.get_page(name), logseq.create_page(name), etc.”

Available Tools

All tools are available under the logseq namespace:

Pages

• logseq.get_all_pages: Get a list of all pages in the Logseq graph
• logseq.get_page: Get a specific page by name
• logseq.create_page: Create a new page
• logseq.delete_page: Delete a page and all its blocks

Blocks

• logseq.get_page_blocks: Get all blocks from a specific page
• logseq.get_block: Get a specific block by ID
• logseq.create_block: Create a new block on a page
• logseq.insert_block: Insert a block as a child of another block
• logseq.update_block: Update an existing block
• logseq.move_block: Move a block to a different location
• logseq.remove_block: Remove a block and all its children
• logseq.search_blocks: Search for blocks matching a query

Working with Logseq

Journal Pages

Journal pages in Logseq have a specific format and attributes:

1. Use the format “mmm dth, yyyy” (e.g., “Apr 4th, 2025”) when creating or accessing journal pages
2. Journal pages are automatically formatted by Logseq with proper dating
3. Journal pages have special attributes that are automatically set by Logseq:
   • journal?: true - Indicates this is a journal page