/ ディレクトリ / プレイグラウンド / mcp-logseq
● コミュニティ ergut ⚡ 即起動

mcp-logseq

作者 ergut · ergut/mcp-logseq

Logseqのグラフをai検索可能に — ページの読み取り、ブロックの作成、プロパティ検索、DSLクエリの実行 — LogseqのローカルHTTP APIを介して実現します。

ergut製のmcp-logseqは、MCPクライアントをLogseqのLocal HTTP APIに接続します。16個のコアツールがページ、ブロック、名前空間、バックリンク、DSLクエリをカバーします。オプションのベクトル検索により、グラフ全体にわたるセマンティックな想起が可能になります。

なぜ使うのか

主な機能

ライブデモ

実際の動作

logseq.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "logseq",
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "logseq": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-logseq"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add logseq -- uvx mcp-logseq

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: mcp-logseq

今週の内容からデイリージャーナルを下書きする

👤 Logseqのパワーユーザー ⏱ ~10 min beginner

使うタイミング: 金曜日の振り返り。今週のジャーナルページをまとめたいとき。

前提条件
  • HTTP APIが有効なLogseq — 設定 > 機能 > HTTP APIsを有効化し、APIトークンを生成
  • LOGSEQ_API_TOKEN + LOGSEQ_API_URL 環境変数 — MCPクライアントのコンフィグに設定
フロー
  1. 先週のジャーナルページを取得
    今週のデイリージャーナルページ(月曜日から今日まで)の内容を取得してください。✓ コピーしました
    → 日ごとのページ内容
  2. 要約と下書き作成
    テーマを要約し、Week Reviewセクション付きで今日のジャーナルを下書きしてください。✓ コピーしました
    → 貼り付け可能な下書き
  3. 書き戻し
    今日のジャーナルページを更新し、Week Reviewセクションを追記してください。✓ コピーしました
    → ページ更新完了

結果: 最小限のタイピングで週を締めくくる振り返りが完成します。

注意点
  • appendモードのupdate_pageはリトライ時にコンテンツが重複する — べき等な操作にはreplaceモードを使用するか、既存コンテンツを事前に確認してください
  • センシティブなタグが要約に漏れる — LOGSEQ_EXCLUDE_TAGS=private,#secretを設定して非表示にしてください

プロパティでページを検索してタスクを一掃する

👤 タスク管理スタイルのページを使うLogseqユーザー ⏱ ~15 min beginner

使うタイミング: プロジェクトページにstatus:: activeタグを付けていて、一覧を取得したいとき。

フロー
  1. プロパティで検索
    find_pages_by_property: status=active。名前とupdated-atを返してください。✓ コピーしました
    → ページ一覧
  2. トリアージ
    各ページの最新3ブロックを取得し、明確なネクストアクションがあるか教えてください。✓ コピーしました
    → ページごとのステータス

結果: アクティブなプロジェクトの一掃と明確なネクストアクションの把握ができます。

グラフ全体にわたるセマンティック検索

👤 大規模なLogseqグラフを持つリサーチャー ⏱ ~10 min intermediate

使うタイミング: キーワード検索では書いたはずのノートが見つからないとき。

前提条件
  • ベクトルDB同期済み — sync_vector_dbを一度実行。大量インポート後は再実行してください
フロー
  1. ベクトル検索
    vector_search: 'テストピラミッドとハニカムについてメモしたこと'✓ コピーしました
    → ランク付きの検索結果
  2. 全文ページ取得
    上位マッチのget_page_contentを実行してください。✓ コピーしました
    → 全コンテンツ

結果: 完全一致ではなく、意味に基づいてノートを発見できます。

議事録ページからアクションアイテムを抽出する

👤 PMおよびチームリーダー ⏱ ~10 min beginner

使うタイミング: Logseqに議事録を記録していて、アクションを分離したいとき。

フロー
  1. 議事録ページを読む
    'Meeting/2026-04-14/engineering-sync'のget_page_contentを実行してください。✓ コピーしました
    → ノート内容
  2. アクション抽出
    TODO形式の行を特定し、それぞれについて担当者と期日を付けて今日のジャーナルの子ブロックとして作成してください。✓ コピーしました
    → ブロック作成完了

結果: ノートからアクションが抽出され、追跡可能なリストになります。

組み合わせ

他のMCPと組み合わせて10倍の力を

logseq + marm-systems

MARMで短期的な想起、Logseqで永続的なノートを管理

これらのMARMコンテキストログをLogseqの/Notes/2026-04配下にページとして移動してください。✓ コピーしました
logseq + filesystem

厳選したLogseqページをMarkdownファイルとしてエクスポート

#publicタグの付いた全ページを./exports/public-notes/に個別の.mdファイルとしてエクスポートしてください。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
list_pages (none) グラフの概要取得 free (local API)
get_page_content name: str ページの読み取り free
create_page name, content, properties? 新規ページ作成 free (write)
update_page name, content, mode: append|replace 既存ページの編集 free (write)
delete_page name: str 破壊的操作 — 確認が必要 free
search query: str 全文検索 free
query dsl: str Logseq DSLクエリ free
find_pages_by_property key: str, value?: str プロパティによるフィルタリング free
get_page_backlinks name: str このノートへのリンク元を確認 free
insert_nested_block parent_uuid, content, position: child|sibling 構造化コンテンツの追加 free (write)
vector_search query: str セマンティック検索 free (local embeddings)

コストと制限

運用コスト

APIクォータ
なし — LogseqのローカルAPIに制限はありません
呼び出しあたりのトークン
list/searchは少量、ページは長くなる場合があります
金額
無料
ヒント
10,000ページ以上のグラフでは、クエリのたびではなく毎晩ベクトルDBを同期することを推奨します。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: LOGSEQ_API_TOKENを環境変数に設定
データ送信先: すべてLogseqのローカルで完結。ベクトルエンベディングもローカルマシン上に保持されます
絶対に付与しない: Exposing Logseq's HTTP API to your LAN without firewalling

トラブルシューティング

よくあるエラーと対処法

Connection refused on localhost:12315

LogseqのプラグアイコンからHTTP APIを起動してください。デフォルトではオフになっています。

確認: curl http://localhost:12315
401 on API calls

トークンが未設定または不一致です。LogseqのAuthorization tokensで再生成してください。

確認: Check token in Logseq settings
vector_search empty

先にsync_vector_dbを実行してください。自動同期はされません。

確認: vector_db_status

代替案

mcp-logseq 他との比較

代替案代わりに使う場面トレードオフ
Obsidian MCP (community)Obsidianを使用している場合グラフのセマンティクスが異なります
Notion MCPNotionを使用している場合有料SaaS。グラフモデルが異なります
filesystem MCP on the Logseq dir生ファイルアクセスのみ必要な場合ブロックレベルの操作やDSLクエリは使用不可

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る