/ Verzeichnis / Playground / mcp-logseq
● Community ergut ⚡ Sofort

mcp-logseq

von ergut · ergut/mcp-logseq

Make your Logseq graph AI-queryable — read pages, create blocks, search by property, run DSL queries — over Logseq's local HTTP API.

mcp-logseq by ergut connects an MCP client to Logseq's Local HTTP API. 16 core tools cover pages, blocks, namespaces, backlinks, and DSL queries. Optional vector search adds semantic recall across the whole graph.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

logseq.replay ▶ bereit
0/0

Installieren

Wählen Sie Ihren Client

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

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

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

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

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

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

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

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

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

Continue nutzt ein Array von Serverobjekten statt einer Map.

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

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add logseq -- uvx mcp-logseq

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: mcp-logseq

Draft today's daily journal from your week

👤 Logseq power users ⏱ ~10 min beginner

Wann einsetzen: Friday reflection; you want a summary of the week's journal pages.

Voraussetzungen
  • Logseq with HTTP API enabled — Settings > Features > enable HTTP APIs; generate API token
  • LOGSEQ_API_TOKEN + LOGSEQ_API_URL env vars — Set in your MCP client config
Ablauf
  1. Pull last week's journal pages
    Get the content of this week's daily journal pages (Monday through today).✓ Kopiert
    → Page contents per day
  2. Summarize and draft
    Summarize themes and draft today's journal with a Week Review section.✓ Kopiert
    → Draft ready to paste
  3. Write back
    Update today's journal page, appending the Week Review section.✓ Kopiert
    → Page updated

Ergebnis: A closing-the-loop weekly reflection with minimal typing.

Fallstricke
  • update_page in append mode duplicates content on retry — Use replace mode for idempotent operations, or check existing content first
  • Sensitive tags leak into summaries — Set LOGSEQ_EXCLUDE_TAGS=private,#secret to hide those

Find pages by property for a task sweep

👤 Logseq users with task-style pages ⏱ ~15 min beginner

Wann einsetzen: You tag project pages with status:: active and want a list.

Ablauf
  1. Find by property
    find_pages_by_property: status=active. Return names and updated-at.✓ Kopiert
    → Page list
  2. Triage
    For each, fetch the page and tell me the last 3 blocks — is there a visible next action?✓ Kopiert
    → Per-page status

Ergebnis: A sweep of active projects with clear next actions.

Semantic recall across your whole graph

👤 Researchers with a huge Logseq graph ⏱ ~10 min intermediate

Wann einsetzen: Keyword search isn't finding a note you know you wrote.

Voraussetzungen
  • Vector DB synced — Run sync_vector_db once; re-run after big imports
Ablauf
  1. Vector search
    vector_search: 'what did I note about test pyramid vs honeycomb?'✓ Kopiert
    → Ranked matches
  2. Pull full page
    get_page_content on the top match.✓ Kopiert
    → Full content

Ergebnis: Finding notes by meaning, not exact words.

Turn a meeting page into tracked action items

👤 PMs and team leads ⏱ ~10 min beginner

Wann einsetzen: You capture meetings in Logseq and want the actions separated.

Ablauf
  1. Read meeting page
    get_page_content for 'Meeting/2026-04-14/engineering-sync'.✓ Kopiert
    → Notes
  2. Extract actions
    Identify TODO-flavored lines. For each, create a child block under today's journal with assignee and due date.✓ Kopiert
    → Blocks created

Ergebnis: Actions lifted out of notes into a trackable list.

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

logseq + marm-systems

Short-lived recall in MARM; durable notes in Logseq

Move these MARM contextual logs into Logseq as pages under /Notes/2026-04.✓ Kopiert
logseq + filesystem

Export curated Logseq pages to Markdown files

Export all pages tagged #public to ./exports/public-notes/ as individual .md files.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
list_pages (none) Graph overview free (local API)
get_page_content name: str Read a page free
create_page name, content, properties? New page free (write)
update_page name, content, mode: append|replace Edit an existing page free (write)
delete_page name: str Destructive — confirm free
search query: str Full-text search free
query dsl: str Logseq DSL query free
find_pages_by_property key: str, value?: str Filter by properties free
get_page_backlinks name: str Who links to this note free
insert_nested_block parent_uuid, content, position: child|sibling Add structured content free (write)
vector_search query: str Semantic recall free (local embeddings)

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
None — Logseq's local API is unbounded
Tokens pro Aufruf
Small for list/search; pages can be long
Kosten in €
Free
Tipp
For graphs with 10k+ pages, keep vector DB synced nightly rather than on every query.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: LOGSEQ_API_TOKEN in env var
Datenabfluss: All local to Logseq; vector embeddings stay on your machine
Niemals gewähren: Exposing Logseq's HTTP API to your LAN without firewalling

Fehlerbehebung

Häufige Fehler und Lösungen

Connection refused on localhost:12315

Start the HTTP API via the plug icon in Logseq. It's off by default.

Prüfen: curl http://localhost:12315
401 on API calls

Token missing or mismatched. Regenerate in Logseq Authorization tokens.

Prüfen: Check token in Logseq settings
vector_search empty

Run sync_vector_db first; it's not auto-synced.

Prüfen: vector_db_status

Alternativen

mcp-logseq vs. andere

AlternativeWann stattdessenKompromiss
Obsidian MCP (community)You use Obsidian insteadDifferent graph semantics
Notion MCPYou're on NotionPaid SaaS; different graph model
filesystem MCP on the Logseq dirYou only need raw file accessNo block-level operations, no DSL queries

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen