mcp-pkm-logseq MCP server

@ruliana

代码仓库

基本信息

分类

记忆与知识

许可证

MIT

传输方式

stdio

作者

ruliana

关于 mcp-pkm-logseq MCP server

A fairly customizable MCP server for Logseq

mcp-pkm-logseq MCP server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-pkm-logseq": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

mcp-pkm-logseq MCP server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is mcp-pkm-logseq?

mcp-pkm-logseq is an MCP server that enables AI assistants to interact with your Logseq Personal Knowledge Management system. It provides tools to retrieve notes and todos from your Logseq graph, guided by a custom instructions page you create. It is intended for users who want LLM-powered access to their Logseq knowledge base.

How to use mcp-pkm-logseq?

Install via uvx mcp-pkm-logseq and configure the environment variables LOGSEQ_API_KEY (default "this-is-my-logseq-mcp-token") and LOGSEQ_URL (default "http://localhost:12315"). Enable Logseq’s built-in HTTP API server in Settings → Advanced → Developer mode, set your API token, then configure your MCP client (e.g., Claude Desktop, Claude Code, Cursor) with the server command and environment variables. A page named “MCP PKM Logseq” should be created in your graph to serve as an AI guide.

Key features of mcp-pkm-logseq?

Provides a guide resource (logseq://guide) for assistant instructions.
Retrieve personal notes by topic and date range.
Retrieve todo items filtered by done status and date range.
Configurable API token and Logseq server URL.
Integrates with Logseq’s HTTP API (port 12315 default).

Use cases of mcp-pkm-logseq?

An AI assistant retrieves notes tagged with specific topics from your Logseq graph.
A chatbot fetches your current or past todos to help with task management.
A personal knowledge assistant uses the guide page to learn your tagging conventions before searching.

常见问题

What environment variables does mcp-pkm-logseq require?

`LOGSEQ_API_KEY` (default: `"this-is-my-logseq-mcp-token"`) for authentication and `LOGSEQ_URL` (default: `"http://localhost:12315"`) for the Logseq HTTP API endpoint.

How do I enable the Logseq HTTP API?

Open Logseq, go to Settings → Advanced, enable “Developer mode” and “HTTP API Server”, then set your API token to match the `LOGSEQ_API_KEY` value.

Where do I configure mcp-pkm-logseq for Claude Desktop?

On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`; on Windows: `%APPDATA%/Claude/claude_desktop_config.json`. Add the server under `mcpServers` with `"command": "uvx"` and `"args": ["mcp-pkm-logseq"]`.

What is the “MCP PKM Logseq” page for?

It is a guide page you create in your Logseq graph containing your tagging system, workflows, naming conventions, and search preferences. The server exposes it as a resource so the AI assistant can understand how to interact with your knowledge base.

How can I debug the server during development?

Use the MCP Inspector by running `npx @modelcontextprotocol/inspector uv --directory <path> run mcp-pkm-logseq`. This provides a browser-based debugging interface.