
A fairly customizable MCP server for Logseq
A fairly customizable MCP server for Logseq
·
A MCP server for interacting with your Logseq Personal Knowledge Management system using custom instructions
logseq://guide - Initial instructions on how to interact with this knowledge baseget_personal_notes_instructions() - Get instructions on how to use the personal notes toolget_personal_notes(topics, from_date, to_date) - Retrieve personal notes from Logseq that are tagged with the specified topicsget_todo_list(done, from_date, to_date) - Retrieve the todo list from LogseqThe following environment variables can be configured:
LOGSEQ_API_KEY: API key for authenticating with Logseq (default: "this-is-my-logseq-mcp-token")LOGSEQ_URL: URL where the Logseq HTTP API is running (default: "http://localhost:12315")On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
"mcpServers": {
"mcp-pkm-logseq": {
"command": "uvx",
"args": [
"mcp-pkm-logseq"
],
"env": {
"LOGSEQ_API_TOKEN": "your-logseq-api-token",
"LOGSEQ_URL": "http://localhost:12315"
}
}
}claude mcp add mcp-pkm-logseq uvx mcp-pkm-logseqLogseq's HTTP API is an interface that runs within your desktop Logseq application. When enabled, it starts a local HTTP server (default port 12315) that allows programmatic access to your Logseq knowledge base. The API supports querying pages and blocks, searching content, and potentially modifying content through authenticated requests.
To enable the Logseq HTTP API server:
LOGSEQ_API_KEY value in the MCP server configuration)For more detailed instructions, see: https://logseq-copilot.eindex.me/doc/setup
Create a page named "MCP PKM Logseq" in your Logseq graph to serve as the guide for AI assistants. Add the following content:
This page will be displayed whenever the AI thinks it needs to understand the user.
To prepare the package for distribution:
uv syncuv buildThis will create source and wheel distributions in the dist/ directory.
uv publishNote: You'll need to set PyPI credentials via environment variables or command flags:
--token or UV_PUBLISH_TOKEN--username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORDSince MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.
You can launch the MCP Inspector via npm with this command:
npx @modelcontextprotocol/inspector uv --directory /Users/ronie/MCP/mcp-pkm-logseq run mcp-pkm-logseqUpon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
"mcpServers": {
"mcp-pkm-logseq": {
"command": "uv",
"args": [
"--directory",
"/<parent-directories>/mcp-pkm-logseq",
"run",
"mcp-pkm-logseq"
],
"env": {
"LOGSEQ_API_TOKEN": "your-logseq-api-token",
"LOGSEQ_URL": "http://localhost:12315"
}
}
}Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add mcp-pkm-logseq -- uvx mcp-pkm-logseq{
"mcpServers": {
"mcp-pkm-logseq": {
"env": {
"LOGSEQ_URL": "",
"LOGSEQ_API_TOKEN": ""
},
"args": [
"mcp-pkm-logseq"
],
"command": "uvx"
}
}
}code --add-mcp '{"name":"mcp-pkm-logseq","env":{"LOGSEQ_URL":"","LOGSEQ_API_TOKEN":""},"args":["mcp-pkm-logseq"],"command":"uvx"}'[mcp_servers.mcp-pkm-logseq]
command = "uvx"
args = ["mcp-pkm-logseq"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/mcp-pkm-logseq-mcp-server to learn what the "mcp-pkm-logseq MCP server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add mcp-pkm-logseq uvx mcp-pkm-logseqnpx @modelcontextprotocol/inspector uv --directory /Users/ronie/MCP/mcp-pkm-logseq run mcp-pkm-logseqThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/mcp-pkm-logseq-mcp-server)Nothing comparable is listed yet.
0.2.2TODOs, dates, and instructionsRelease notes0.2.1First usable versionRelease notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "mcp-pkm-logseq-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.