Logseq MCP Tools logo

Logseq MCP Tools

by joelhooks

Logseq MCP Tools is a Model Context Protocol (MCP) server that provides AI assistants with structured access to your Logseq knowledge graph. It allows AI assistants like Claude to interact with your Logseq knowledge base.

View on GitHub

Last updated: N/A

What is Logseq MCP Tools?

This project is an MCP server that allows AI assistants to interact with your Logseq knowledge base, providing structured access to your notes and connections.

How to use Logseq MCP Tools?

  1. Clone the repository. 2. Install dependencies. 3. Configure your Logseq token in the .env file. 4. Run the server using npm start or npx tsx index.ts. 5. Configure your AI assistant (Claude or Cursor) to connect to the MCP server using the provided instructions.

Key features of Logseq MCP Tools

  • Retrieves a list of all pages

  • Gets content from specific pages

  • Generates journal summaries for flexible date ranges

  • Extracts linked pages and explores connections

  • Performs knowledge graph analysis

  • Suggests connections between pages

Use cases of Logseq MCP Tools

  • Summarizing notes from a specific date range

  • Finding all pages related to a specific topic

  • Analyzing patterns in journal entries

  • Identifying knowledge gaps in your graph

  • Suggesting connections between different pages

  • Creating new pages

FAQ from Logseq MCP Tools

How do I find my Logseq auth token?

Open Logseq, enable the HTTP API in Settings > Features > Enable HTTP API, and set your authentication token in Settings > Features > HTTP API Authentication Token.

Claude Desktop can't access the Node.js binaries, what do I do?

If you're using a Node.js version manager, install a system-wide Node.js with Homebrew using brew install node.

How do I verify my setup?

Ensure Logseq is running with the HTTP API enabled, verify your auth token in .env, and check that the path to your index.ts file is correct. Try running npx tsx index.ts directly in your terminal.

How can I view logs in Claude Desktop?

Monitor logs in real-time using tail -n 20 -F ~/Library/Logs/Claude/mcp*.log on macOS.

What if I have more detailed debugging questions?

Refer to the official MCP debugging documentation at https://modelcontextprotocol.io/docs/tools/debugging.