mcp-logseq MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

16 tools for pages, blocks, namespaces, and Logseq DSL queries
Optional semantic vector search (vector_search, sync_vector_db)
Markdown-aware — create_page and update_page handle Logseq block formatting
DB-mode property support via LOGSEQ_DB_MODE
Tag exclusion filter (LOGSEQ_EXCLUDE_TAGS) to hide private pages from AI

Demo ao vivo

Como fica na prática

logseq.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "logseq",
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "logseq": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-logseq"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add logseq -- uvx mcp-logseq

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: mcp-logseq

Draft today's daily journal from your week

👤 Logseq power users ⏱ ~10 min beginner

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

Pré-requisitos

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

Fluxo

Pull last week's journal pages

Get the content of this week's daily journal pages (Monday through today).✓ Copiado

→ Page contents per day
Summarize and draft

Summarize themes and draft today's journal with a Week Review section.✓ Copiado

→ Draft ready to paste
Write back

Update today's journal page, appending the Week Review section.✓ Copiado

→ Page updated

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

Armadilhas

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

Quando usar: You tag project pages with status:: active and want a list.

Fluxo

Find by property

find_pages_by_property: status=active. Return names and updated-at.✓ Copiado

→ Page list
Triage

For each, fetch the page and tell me the last 3 blocks — is there a visible next action?✓ Copiado

→ Per-page status

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

Semantic recall across your whole graph

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

Quando usar: Keyword search isn't finding a note you know you wrote.

Pré-requisitos

Vector DB synced — Run sync_vector_db once; re-run after big imports

Fluxo

Vector search

vector_search: 'what did I note about test pyramid vs honeycomb?'✓ Copiado

→ Ranked matches
Pull full page

get_page_content on the top match.✓ Copiado

→ Full content

Resultado: Finding notes by meaning, not exact words.

Turn a meeting page into tracked action items

👤 PMs and team leads ⏱ ~10 min beginner

Quando usar: You capture meetings in Logseq and want the actions separated.

Fluxo

Read meeting page

get_page_content for 'Meeting/2026-04-14/engineering-sync'.✓ Copiado

→ Notes
Extract actions

Identify TODO-flavored lines. For each, create a child block under today's journal with assignee and due date.✓ Copiado

→ Blocks created

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

Combinações

Combine com outros MCPs para 10× de alavancagem

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.✓ Copiado

logseq + filesystem

Export curated Logseq pages to Markdown files

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

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
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)

Custo e limites

O que custa rodar

Cota de API: None — Logseq's local API is unbounded
Tokens por chamada: Small for list/search; pages can be long
Monetário: Free
Dica: For graphs with 10k+ pages, keep vector DB synced nightly rather than on every query.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: LOGSEQ_API_TOKEN in env var

Saída de dados: All local to Logseq; vector embeddings stay on your machine

Nunca conceda: Exposing Logseq's HTTP API to your LAN without firewalling

Logseq's HTTP API has full graph write access — protect the token as a secret.
Use LOGSEQ_EXCLUDE_TAGS to redact private pages from AI visibility.

Solução de problemas

Erros comuns e correções

Connection refused on localhost:12315

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

Verificar: curl http://localhost:12315

401 on API calls

Token missing or mismatched. Regenerate in Logseq Authorization tokens.

Verificar: Check token in Logseq settings

vector_search empty

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

Verificar: vector_db_status

Alternativas

mcp-logseq vs. outros

Alternativa	Quando usar	Troca
Obsidian MCP (community)	You use Obsidian instead	Different graph semantics
Notion MCP	You're on Notion	Paid SaaS; different graph model
filesystem MCP on the Logseq dir	You only need raw file access	No block-level operations, no DSL queries

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills