MCP Pkm Logseq

An MCP server for interacting with the Logseq personal knowledge management system through custom instructions, providing note retrieval and to-do item management functions

Knowledge management and memory Note-taking tools #Knowledge Management #Note Tool #To-Do List .Python

rating : 2.5 points

downloads : 16

update time : 2025-04-29

Introduction

The MCP Log Sequence Knowledge Management Server is a local tool that allows AI assistants to access and query your Logseq note data through the log context protocol. It supports multiple functions, including searching note content by tags, dates, and other attributes.

Main Features

The server provides the following core functions: 1) Intelligent note retrieval 2) Tag and classification management 3) Time range query 4) Note content analysis 5) Secure data access. All operations are performed locally to ensure data privacy.

Use Cases

Suitable for various scenarios that require quick retrieval and analysis of note content, such as knowledge review, project management, research support, etc. It is particularly suitable for efficient knowledge processing in combination with AI assistants.

MCP Log Sequence Knowledge Management System

Intelligent Note RetrievalSupports quick retrieval of relevant note content through multiple methods such as tags, keywords, and time ranges.

To-Do Item IntegrationDeeply integrated with Logseq's to-do module, providing task query and management functions.

Content Analysis ToolBuilt-in natural language processing capabilities can automatically summarize note content and extract keywords.

🚀 Logseq Personal Knowledge Management System MCP Server

An MCP server for interacting with your Logseq personal knowledge management system, supporting custom commands.

🚀 Quick Start

📦 Installation

Usage on Claude Desktop and Cursor:

MacOS system path: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows system path: %APPDATA%/Claude/claude_desktop_config.json%

Example configuration for the published server

"mcpServers": {
  "mcp-pkm-logseq": {
    "command": "uvx",
    "args": [
      "mcp-pkm-logseq"
    ],
    "env": {
      "LOGSEQ_API_TOKEN": "your-logseq-api-token",
      "LOGSEQ_URL": "http://localhost:12315"
    }
  }
}

Run in Claude Code:

claude mcp add mcp-pkm-logseq uvx mcp-pkm-logseq

Start the Logseq Server

The Logseq HTTP interface is an interface that runs in the desktop version of the Logseq application. Once enabled, it starts a local HTTP server (default port: 12315), allowing authenticated requests to access your Logseq knowledge base. This interface supports querying pages and blocks, searching for content, and possible content modifications.

To enable the Logseq HTTP interface server:

Open Logseq and go to the settings in the top right corner.
Navigate to the advanced options.
Enable "Developer mode".
Enable the "HTTP API server".
Set your API key (this should match the LOGSEQ_API_KEY value in the MCP server configuration).

For more detailed instructions, please refer to: https://logseq-copilot.eindex.me/doc/setup

Create an MCP PKM Logseq Page

Create a new page named "MCP PKM Logseq" to store commands related to the knowledge management system.

✨ Features

Resources

logseq://guide - Initial command guide, introducing how to interact with this knowledge base

Tools

get_personal_notes_instructions() - Get instructions on using the personal notes tool
get_personal_notes(topics, from_date, to_date) - Retrieve personal notes with specified topic tags
get_todo_list(done, from_date, to_date) - Retrieve the to-do list in Logseq

🔧 Technical Details

Configuration

The following environment variables can be configured:

Property	Details
`LOGSEQ_API_KEY`	API key for authentication with Logseq (default value: "this-is-my-logseq-mcp-token")
`LOGSEQ_URL`	URL address where the Logseq HTTP API runs (default value: "http://localhost:12315")

🚧 Development

Build and Publish

Use the following command to build and publish the project:

npm run build

Then run the published script:

node dist/index.js

Debugging

Add debug logs in the development environment to more easily troubleshoot issues.

Add Development Server Configuration to Claude Desktop

Add the following content to your development server configuration:

{
  "mcpServers": {
    "mcp-pkm-logseq": {
      "command": "uvx",
      "args": [
        "mcp-pkm-logseq"
      ],
      "env": {
        "LOGSEQ_API_TOKEN": "your-logseq-api-token",
        "LOGSEQ_URL": "http://localhost:12315"
      }
    }
  }
}