Logseq MCP Tools

Name: Logseq MCP Tools
Author: apw124

@apw124

Repository

About Logseq MCP Tools

MCP Server for interacting with LogSeq graph

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "logseq-mcp"
      ],
      "env": {
        "LOGSEQ_API_URL": "",
        "LOGSEQ_TOKEN": ""
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Logseq MCP Tools?

Logseq MCP Tools is a set of Model Context Protocol (MCP) tools that enable AI agents to interact with a local Logseq instance. It is designed for users who want to automate tasks in their Logseq graph via AI assistants like Cursor or Claude.

How to use Logseq MCP Tools?

Install Python 3.11+, clone the repository, and run pip install -e .. Enable Logseq’s Developer mode and API, set an API token in Logseq’s Advanced settings, then configure the MCP server in your Cursor MCP configuration (~/.cursor/mcp.json) or via claude mcp add with the environment variables LOGSEQ_API_URL and LOGSEQ_TOKEN. All tools are available under the logseq namespace.

Key features of Logseq MCP Tools

Manage pages: get all, get, create, delete
Manage blocks: get, create, insert, update, move, remove, search
Works with journal pages using proper date format
All tools exposed under the logseq namespace
Integrates with Cursor and Claude via MCP protocol

Use cases of Logseq MCP Tools

Create a new page with bullet points for a meeting agenda
Add today’s tasks to your journal page
Update a journal entry with project links and child blocks
Search the graph for blocks about a topic and organize them on a new page

FAQ from Logseq MCP Tools

What prerequisites are needed?

Python 3.11+ and a local Logseq instance with Developer mode enabled, Developer Plugin turned on, and an API token set in Advanced settings.

How do I configure the MCP server?

Set the environment variables LOGSEQ_API_URL (default http://localhost:12315) and LOGSEQ_TOKEN in either your Cursor mcp.json config or when adding the server via claude mcp add.

What tools does Logseq MCP Tools provide?

Page tools: logseq.get_all_pages, logseq.get_page, logseq.create_page, logseq.delete_page. Block tools: logseq.get_page_blocks, logseq.get_block, logseq.create_block, logseq.insert_block, logseq.update_block, logseq.move_block, logseq.remove_block, logseq.search_blocks.

How do journal pages work?

Use the format “mmm dth, yyyy” (e.g., “Apr 4th, 2025”) when creating or accessing journal pages. Logseq automatically sets the journal? and journalDay attributes.