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

Por qué usarlo

Características clave

16 herramientas para páginas, bloques, espacios de nombres y consultas Logseq DSL
Búsqueda de vectores semánticos opcional (vector_search, sync_vector_db)
Compatible con Markdown: create_page y update_page manejan el formato de bloque Logseq
Soporte de propiedades en modo DB a través de LOGSEQ_DB_MODE
Filtro de exclusión de etiquetas (LOGSEQ_EXCLUDE_TAGS) para ocultar páginas privadas de la IA

Demo en vivo

Cómo se ve en la práctica

logseq.replay ▶ listo

0/0

Instalar

Elige tu 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
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

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

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add logseq -- uvx mcp-logseq

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: mcp-logseq

Redactar el diario de hoy de tu semana.

👤 Usuarios avanzados de Logseq ⏱ ~10 min beginner

Cuándo usarlo: Reflexión del viernes; Quieres un resumen de las páginas del diario de la semana.

Requisitos previos

Logseq con API HTTP habilitada — Configuración > Funciones > habilitar API HTTP; generar token API
LOGSEQ_API_TOKEN + LOGSEQ_API_URL variables de entorno — Establecer en la configuración de su cliente MCP

Flujo

Saque las páginas del diario de la semana pasada

Obtenga el contenido de las páginas del diario de esta semana (de lunes a hoy).✓ Copiado

→ Contenido de la página por día
Resumir y redactar

Resuma temas y redacte el diario de hoy con una sección de Revisión semanal.✓ Copiado

→ Borrador listo para pegar
Contestar

Actualice la página del diario de hoy, agregando la sección Revisión de la semana.✓ Copiado

→ Página actualizada

Resultado: Una reflexión semanal de cierre del ciclo con un mínimo de escritura.

Errores comunes

update_page en modo agregar duplica el contenido al reintentar — Utilice el modo de reemplazo para operaciones idempotentes o verifique primero el contenido existente
Las etiquetas confidenciales se filtran en los resúmenes — Establezca LOGSEQ_EXCLUDE_TAGS=private,#secret para ocultarlos

Buscar páginas por propiedad para un barrido de tareas

👤 Usuarios de Logseq con páginas de estilo tarea ⏱ ~15 min beginner

Cuándo usarlo: Etiquetas las páginas del proyecto con estado:: activo y quieres una lista.

Flujo

Buscar por propiedad

find_pages_by_property: estado = activo. Devuelve nombres y actualizado en.✓ Copiado

→ Lista de páginas
Triaje

Para cada uno, busca la página y dime los últimos 3 bloques. ¿Hay una siguiente acción visible?✓ Copiado

→ Estado por página

Resultado: Un barrido de proyectos activos con próximas acciones claras.

Recuerdo semántico en todo el gráfico

👤 Investigadores con un enorme gráfico Logseq ⏱ ~10 min intermediate

Cuándo usarlo: La búsqueda de palabras clave no consiste en encontrar una nota que sabes que escribiste.

Requisitos previos

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

Flujo

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

Cuándo usarlo: You capture meetings in Logseq and want the actions separated.

Flujo

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.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

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

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
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)

Coste y límites

Lo que cuesta ejecutarlo

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

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: LOGSEQ_API_TOKEN in env var

Salida de datos: All local to Logseq; vector embeddings stay on your machine

No conceder nunca: 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.

Resolución de problemas

Errores comunes y soluciones

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 otros

Alternativa	Cuándo usarla	Contrapartida
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

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills