Logseq MCP Tools

Logseq MCPツール
このプロジェクトは、AI エージェントがローカル Logseq インスタンスと対話できるようにする Model Context Protocol (MCP) ツールのセットを提供します。
インストール
Python 3.11以降がインストールされていることを確認してください
このリポジトリをクローンする
依存関係をインストールします:
pip install -e .
Related MCP server: Logseq MCP Tools
設定
Logseq で API が有効になっていることを確認してください。
Logseqで、「設定」>「詳細設定」>「開発者モード」>「開発者モードを有効にする」に移動します。
次に、プラグイン > Logseq Developer プラグインをオンにします。
詳細設定でAPIトークンも設定します
Logseqを再起動する
Cursor MCP 構成ファイル (通常は
~/.cursor/mcp.json) で MCP サーバーを構成します。{ "mcpServers": { "logseq": { "command": "/opt/homebrew/bin/uvx", "args": ["logseq-mcp"], "env": { "LOGSEQ_API_URL": "http://localhost:12315", "LOGSEQ_TOKEN": "your-token-here" } } } }
または
次のようにして Claude Code を MCP サーバーを使用するように構成します。
claude mcp add範囲を選択
Stdioを選択
LOGSEQ_API_URL=http://localhost:12315 LOGSEQ_TOKEN=your-token-here /opt/homebrew/bin/uvx logseq-mcp
カーソルとクロードと併用
カーソルのMCPツールへの追加
上記のセットアップセクションに示すようにMCPサーバーを構成します。
カーソルを開いてMCPパネル(サイドバー)に移動します
Logseqツールが利用可能なツールのリストに表示されるはずです。
クロードと一緒に使う
Cursor で Claude を使用する場合は、次のようなプロンプトで Logseq ツールが利用可能であることを通知する必要があります。
「Logseq グラフの操作に役立つ Logseq ツールにアクセスできます。logseq.get_all_pages()、logseq.get_page(name)、logseq.create_page(name) などの関数を使用できます。」
利用可能なツール
すべてのツールは、 logseq名前空間で使用できます。
ページ
logseq.get_all_pages: Logseq グラフ内のすべてのページのリストを取得します。logseq.get_page: 名前で特定のページを取得するlogseq.create_page: 新しいページを作成するlogseq.delete_page: ページとそのすべてのブロックを削除する
ブロック
logseq.get_page_blocks: 特定のページからすべてのブロックを取得するlogseq.get_block: IDで特定のブロックを取得するlogseq.create_block: ページに新しいブロックを作成するlogseq.insert_block: ブロックを別のブロックの子として挿入するlogseq.update_block: 既存のブロックを更新するlogseq.move_block: ブロックを別の場所に移動するlogseq.remove_block: ブロックとそのすべての子ブロックを削除しますlogseq.search_blocks: クエリに一致するブロックを検索する
Logseqの操作
ジャーナルページ
Logseq のジャーナル ページには、特定の形式と属性があります。
ジャーナルページを作成またはアクセスするときは、「mmm dth, yyyy」(例:「2025年4月4日」)という形式を使用します。
ジャーナルページはLogseqによって適切な日付で自動的にフォーマットされます
ジャーナル ページには、Logseq によって自動的に設定される特別な属性があります。
journal?: true - これはジャーナルページであることを示しますjournalDay: YYYYMMDD - 数値形式の日付(例:2025年4月4日の場合は20250404)
例:
await logseq.create_page("Apr 4th, 2025")
重要: journal?属性またはjournalDay属性を手動で設定する必要はありません。適切な日付形式(例: 「2025年4月4日」)でページを作成するだけで、適切な属性を持つジャーナルページとして自動的に設定されます。
ブロック構造とフォーマット
Logseq のブロックには、理解しておくべき重要な特性がいくつかあります。
自動箇条書き: すべてのブロックはLogseq UIで自動的に箇条書きとしてレンダリングされます。
ページリンク: 二重括弧を使用してリンクを作成します:
[[Page Name]]階層ブロック:
ブロック構造データには階層情報が含まれています。
parent: 親ブロックのIDlevel: インデントレベル(トップレベルの場合は1、インデントされたブロックの場合は2以上)left: 左のブロック(通常はインデントされたブロックの親)
ブロックコンテンツ: ブロックを作成するときに、テキストの書式設定を含めることができます。
基本的な Markdown がサポートされています (太字、斜体など)
ブロック内の箇条書きはサポートが限られる場合があります
複数行のコンテンツはサポートされていますが、Logseqの解析ルールの対象となる場合があります。
ジャーナル ブロック: ジャーナル ページで作成されたブロックは特別な属性を継承します。
journal?: 本当journalDay: YYYYMMDD - ジャーナルページと同じ
**注:**ジャーナルページと同様に、これらのブロック属性はLogseqによって自動的に処理されます。ジャーナルページにブロックを作成する際にjournal?属性やjournalDay属性を手動で設定する必要はありません。
一般的なタスクでの使用例
Cursor エージェントの操作: Cursor で Logseq MCP ツールが設定されている場合は、次のようなエージェント プロンプトを出すことができます。
「今日の議題を箇条書きにした『会議メモ』という新しいページを作成します」
「「タスク」セクションを使用して、今日のタスクをジャーナルページに追加します」
「今日のジャーナルエントリを[[プロジェクト計画]]で更新し、その子要素を「完了したマイルストーン1」に設定する」
「グラフで「Python プロジェクト」に関するブロックを検索し、新しいページに整理します」
エージェントは適切な Logseq ツールを使用して、グラフ上でこれらの操作を実行します。
Available Tools
13 toolscreate_blockA
Creates a new block on a page in the Logseq graph.
IMPORTANT NOTES:
1. All blocks are automatically formatted as bullet points in Logseq UI
2. To create links to other pages, use double brackets: [[Page Name]]
When creating blocks on journal pages:
- The block will inherit the "journal?" and "journalDay" attributes from the page
- "journalDay" will be in YYYYMMDD format (e.g., 20250404 for April 4, 2025)
Args:
page_name (str): The name of the page to create the block on.
content (str): The content of the new block.
properties (dict, optional): Properties to set on the new block.
Returns:
dict: Information about the created block.
Inputs: page_name (required), content (required), properties.
create_pageA
Creates a new page in the Logseq graph.
For journal pages, use the format "mmm dth, yyyy" (e.g., "Apr 4th, 2025").
Journal pages are specially formatted in Logseq with automatic dating.
When you create a journal page, Logseq automatically:
- Sets "journal?": true
- Sets "journalDay": YYYYMMDD (e.g., 20250404 for April 4, 2025)
- Formats the page as a journal entry
Args:
name (str): The name of the new page.
properties (dict, optional): Properties to set on the new page.
Returns:
dict: Information about the created page.
Inputs: name (required), properties.
delete_pageA
Deletes a page from the Logseq graph.
This operation removes the specified page and all its blocks. This action cannot be undone.
For journal pages, use the format "mmm dth, yyyy" (e.g., "Apr 4th, 2025").
Args:
name (str): The name of the page to delete.
Returns:
dict: Result of the deletion operation.
Inputs: name (required).
get_all_pagesA
Gets all pages from the Logseq graph.
Journal pages can be identified by the "journal?" attribute set to true and
will include a "journalDay" attribute in the format YYYYMMDD.
Returns:
list: A list of all pages in the Logseq graph.
Inputs: no named parameters.
get_blockA
Gets a specific block from the Logseq graph by its ID.
The returned block contains information about its hierarchical structure:
- parent: The parent block's ID
- level: The indentation level (1 for top-level, 2+ for indented blocks)
- left: The block to the left (typically the parent for indented blocks)
If the block is from a journal page, it will include:
- "journal?": true
- "journalDay": YYYYMMDD - Date in numeric format
Args:
block_id (str): The ID of the block to retrieve.
Returns:
dict: Information about the requested block.
Inputs: block_id (required).
get_pageA
Gets a specific page from the Logseq graph by name.
For journal pages, use the format "mmm dth, yyyy" (e.g., "Apr 4th, 2025").
Note that journal pages are automatically created in Logseq with this date format.
Journal pages have specific attributes:
- "journal?": true - Indicates this is a journal page
- "journalDay": YYYYMMDD - The date in numeric format (e.g., 20250404 for April 4, 2025)
Args:
name (str): The name of the page to retrieve.
Returns:
dict: Information about the requested page.
Inputs: name (required).
get_page_blocksA
Gets all blocks from a specific page in the Logseq graph.
For journal pages, use the format "mmm dth, yyyy" (e.g., "Apr 4th, 2025").
Returned blocks contain information about their hierarchical structure:
- parent: The parent block's ID
- level: The indentation level (1 for top-level, 2+ for indented blocks)
- left: The block to the left (typically the parent for indented blocks)
Blocks from journal pages will have:
- "journal?": true
- "journalDay": YYYYMMDD - The date in numeric format (e.g., 20250404)
Args:
page_name (str): The name of the page to retrieve blocks from.
Returns:
list: A list of blocks from the specified page.
Inputs: page_name (required).
get_page_linked_referencesA
Gets all linked references to a specific page in the Logseq graph.
This returns blocks that contain links to the specified page using
the Logseq double bracket notation: [[Page Name]].
For journal pages, use the format "mmm dth, yyyy" (e.g., "Apr 4th, 2025").
Args:
page_name (str): The name of the page to find references to.
Returns:
list: A list of blocks that reference the specified page.
Inputs: page_name (required).
insert_blockA
Inserts a new block as a child of the specified parent block.
This allows for creating hierarchical content by adding children to existing blocks.
IMPORTANT NOTES:
1. All blocks are automatically formatted as bullet points in Logseq UI
2. To create links to other pages, use double brackets: [[Page Name]]
3. The new block will be inserted at the beginning or end of the parent's children
depending on the 'before' parameter
When inserting blocks into journal pages:
- The block will inherit the "journal?" and "journalDay" attributes
- "journalDay" will be in YYYYMMDD format (e.g., 20250404 for April 4, 2025)
Args:
parent_block_id (str): The ID of the parent block to insert under.
content (str): The content of the new block.
properties (dict, optional): Properties to set on the new block.
before (bool, optional): Whether to insert at the beginning of children.
Default is False (append at the end).
Returns:
dict: Information about the created block.
Inputs: parent_block_id (required), content (required), properties, before.
move_blockA
Moves a block to a new location in the graph.
This allows for reorganizing the structure of blocks in the graph by moving
a block (and all its children) to a different location.
IMPORTANT NOTES:
1. The block will maintain its children when moved
2. The hierarchical position depends on the 'as_child' parameter:
- If as_child=True: The block becomes a child of the target block
- If as_child=False: The block becomes a sibling after the target block
Args:
block_id (str): The ID of the block to move.
target_block_id (str): The ID of the target block to move to.
as_child (bool, optional): Whether to make the block a child of the target.
Default is False (insert as sibling).
Returns:
dict: Result of the move operation.
Inputs: block_id (required), target_block_id (required), as_child.
remove_blockA
Removes a block from the Logseq graph.
This operation permanently removes the specified block and all its children.
This action cannot be undone.
To remove a block, you need its block ID, which can be obtained from:
- get_page_blocks() function
- get_block() function
- search_blocks() function
Args:
block_id (str): The ID of the block to remove.
Returns:
dict: Result of the removal operation.
Inputs: block_id (required).
search_blocksA
Searches for blocks matching a query in the Logseq graph.
Examples of useful queries:
- page:"Page Name" - find all blocks on a specific page
- "search term" - find blocks containing the term
- page:"Apr 4th, 2025" - find all blocks in a journal
- [[Page Name]] - find references to a specific page
Returned blocks from journal pages will include:
- "journal?": true
- "journalDay": YYYYMMDD - The date in numeric format
Args:
query (str): The search query.
Returns:
list: A list of blocks matching the search query.
Inputs: query (required).
update_blockA
Updates an existing block in the Logseq graph.
IMPORTANT NOTES:
1. All blocks are automatically formatted as bullet points in Logseq UI
2. To create links to other pages, use double brackets: [[Page Name]]
When updating blocks on journal pages:
- The "journal?" and "journalDay" attributes will be preserved
- "journalDay" will remain in YYYYMMDD format (e.g., 20250404)
Args:
block_id (str): The ID of the block to update.
content (str): The new content for the block.
properties (dict, optional): Properties to update on the block.
Returns:
dict: Information about the updated block.
Inputs: block_id (required), content (required), properties.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool has a clearly distinct purpose with no overlap. For example, create_block and insert_block serve different functions (creating a block on a page vs. inserting a block as a child), and get_page_blocks and search_blocks target different retrieval methods. The descriptions reinforce these distinctions, making misselection unlikely.
All tool names follow a consistent verb_noun pattern with snake_case, such as create_block, get_page, and update_block. This uniformity makes the tool set predictable and easy to navigate, with no deviations in naming conventions.
With 13 tools, the set is well-scoped for managing a Logseq graph, covering essential operations like CRUD for pages and blocks, hierarchical manipulation, and search. Each tool serves a clear purpose without redundancy, making the count appropriate for the domain.
The tool set provides comprehensive coverage for Logseq graph management, including full CRUD for pages and blocks, hierarchical operations (move_block, insert_block), retrieval methods (get_all_pages, search_blocks), and advanced features like linked references. There are no obvious gaps that would hinder agent workflows.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Persistent memory, knowledge graph, task management and more for AI agents via MCP.
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Related MCP Servers
- AlicenseBqualityBmaintenanceA server that enables LLMs to programmatically interact with Logseq knowledge graphs, allowing creation and management of pages and blocks.1050 PyPI47MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides AI assistants with structured access to your Logseq knowledge graph, enabling retrieval, searching, analysis, and creation of content within your personal knowledge base.70MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables AI agents to interact with local Logseq knowledge graphs, supporting operations like creating/editing pages and blocks, searching content, and managing journal entries.1315MIT
- AlicenseNot gradedqualityBmaintenanceA Model Context Protocol (MCP) server implementation that enables AI assistants to interact with Anytype's API through natural language, allowing users to manage their knowledge base through conversation.71,433 npm544MIT