Logseq MCP Tools logo

Logseq MCP Tools

by apw124

Logseq MCP Tools provide a set of Model Context Protocol (MCP) tools that enable AI agents to interact with your local Logseq instance. This allows AI agents like Cursor and Claude to read and modify your Logseq graph.

View on GitHub

Last updated: N/A

What is Logseq MCP Tools?

Logseq MCP Tools is a set of tools that allow AI agents to interface with your Logseq graph using the Model Context Protocol (MCP). It provides a server that exposes Logseq's functionality to AI agents, enabling them to read, create, update, and delete pages and blocks.

How to use Logseq MCP Tools?

  1. Install Python 3.11+ and clone the repository. 2. Install dependencies using pip install -e .. 3. Enable the Logseq API and set an API token in Logseq's developer settings. 4. Configure the MCP server in your Cursor MCP configuration file. 5. Inform AI agents like Claude about the available Logseq tools via prompts.

Key features of Logseq MCP Tools

  • Allows AI agents to interact with Logseq

  • Supports creating, reading, updating, and deleting pages and blocks

  • Provides tools for managing journal pages

  • Integrates with Cursor and Claude

  • Offers a variety of functions for manipulating Logseq data

Use cases of Logseq MCP Tools

  • Automating note-taking and organization in Logseq

  • Integrating Logseq with AI-powered workflows

  • Using AI agents to search and analyze information in your Logseq graph

  • Creating and managing tasks and projects in Logseq with AI assistance

FAQ from Logseq MCP Tools

What is MCP?

Model Context Protocol (MCP) is a protocol that allows AI agents to interact with external tools and services.

What Logseq version is required?

The tools require Logseq with the API enabled and a developer token set.

How do I enable the Logseq API?

Go to Settings > Advanced > Developer mode > Enable Developer mode. Then, go to Plugins > Turn on Logseq Developer Plugin. Also set an API token in the Advanced settings.

How do I configure the MCP server?

Configure the MCP server in your Cursor MCP configuration file (typically at ~/.cursor/mcp.json) with the appropriate command, arguments, and environment variables (LOGSEQ_API_URL and LOGSEQ_TOKEN).

How do I use these tools with Claude?

Inform Claude that you have Logseq tools available with a prompt similar to: "You have access to Logseq tools that can help you interact with my Logseq graph. You can use functions like logseq.get_all_pages(), logseq.get_page(name), logseq.create_page(name), etc."