logseq-mcp MCP Server

Targets the file/Markdown ("OG") version of Logseq — and plain-text files are part of why a graph makes good agent memory: git-syncable, greppable, durable, no lock-in. The newer DB (SQLite) version…

Local serverstdio

What is the logseq-mcp Server?

logseq-mcp is an MCP project maintained in the dailydaniel/logseq-mcp repository. The maintainer describes its purpose as “Targets the file/Markdown ("OG") version of Logseq — and plain-text files are part of why a graph makes good agent memory: git-syncable, greppable, durable, no…”. Read the project documentation for the complete scope.

Installation

The documented pypi package is mcp-server-logseq. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares LOGSEQ_API_TOKEN, LOGSEQ_API_URL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
searchfull-text search over block content (query, regex?, limit?,
find_taskstask blocks by markers?, tag?, under_tag? (descendant),
list_pagespage names under a namespace prefix? (depth? limits levels).
custom_queryrun a named query from the config (name, inputs?).
list_custom_querieslist the configured queries.
datascript_queryrun a raw Datalog query (query, inputs?, rules?).
get_logseq_guidereturns the authoritative guide for querying/writing this
read_pagea page as a normalized block tree (page, depth?). A date
read_blocka block and its children (uuid, depth?).
write_notecreate/append/replace a page under agent_write_prefix
set_page_propertiesset/remove page properties (subpath, properties;
edit_blockreplace one block's content (uuid, old_content,
create_taskcreate a task block in the agent namespace (title, agent,
set_task_statuschange only a task's marker (uuid, status); gated by
list_work_projectsthe closed set of projects a note may be filed under
list_agentsthe closed set of names a note may be signed with, as
add_journal_noteappend HH:MM to today's journal under a
get_worklog_setup_templatethe worklog section for an agent's instructions

How to install the logseq-mcp Server

{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-server-logseq"
      ],
      "env": {
        "LOGSEQ_API_TOKEN": "YOUR_LOGSEQ_API_TOKEN",
        "LOGSEQ_API_URL": "http://127.0.0.1:12315"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
LOGSEQ_API_TOKENDeclared in the maintainer’s client configuration.Check documentation
LOGSEQ_API_URLDeclared in the maintainer’s client configuration.Check documentation