Overview
What is Logseq MCP Tools?
Logseq MCP Tools is a set of Model Context Protocol (MCP) tools that enable AI agents to interact with a local Logseq instance. It is designed for users who want to automate tasks in their Logseq graph via AI assistants like Cursor or Claude.
How to use Logseq MCP Tools?
Install Python 3.11+, clone the repository, and run pip install -e .. Enable Logseq’s Developer mode and API, set an API token in Logseq’s Advanced settings, then configure the MCP server in your Cursor MCP configuration (~/.cursor/mcp.json) or via claude mcp add with the environment variables LOGSEQ_API_URL and LOGSEQ_TOKEN. All tools are available under the logseq namespace.
Key features of Logseq MCP Tools
- Manage pages: get all, get, create, delete
- Manage blocks: get, create, insert, update, move, remove, search
- Works with journal pages using proper date format
- All tools exposed under the
logseqnamespace - Integrates with Cursor and Claude via MCP protocol
Use cases of Logseq MCP Tools
- Create a new page with bullet points for a meeting agenda
- Add today’s tasks to your journal page
- Update a journal entry with project links and child blocks
- Search the graph for blocks about a topic and organize them on a new page
FAQ from Logseq MCP Tools
What prerequisites are needed?
Python 3.11+ and a local Logseq instance with Developer mode enabled, Developer Plugin turned on, and an API token set in Advanced settings.
How do I configure the MCP server?
Set the environment variables LOGSEQ_API_URL (default http://localhost:12315) and LOGSEQ_TOKEN in either your Cursor mcp.json config or when adding the server via claude mcp add.
What tools does Logseq MCP Tools provide?
Page tools: logseq.get_all_pages, logseq.get_page, logseq.create_page, logseq.delete_page. Block tools: logseq.get_page_blocks, logseq.get_block, logseq.create_block, logseq.insert_block, logseq.update_block, logseq.move_block, logseq.remove_block, logseq.search_blocks.
How do journal pages work?
Use the format “mmm dth, yyyy” (e.g., “Apr 4th, 2025”) when creating or accessing journal pages. Logseq automatically sets the journal? and journalDay attributes.
What data transport and authentication does Logseq MCP Tools use?
The server communicates with the local Logseq HTTP API using stdio transport and requires an API token for authentication.
