MCP server for LogSeq
Servidor MCP para LogSeq
Servidor MCP para interactuar con LogSeq a través de su API.
Componentes
Herramientas
El servidor implementa múltiples herramientas para interactuar con LogSeq:
list_graphs: enumera todos los gráficos disponibles
list_pages: enumera todas las páginas del gráfico actual
get_page_content: Devuelve el contenido de una sola página
Buscar: busca contenido en todas las páginas
create_page: Crea una nueva página
update_page: Actualizar el contenido de una página existente
delete_page: Eliminar una página
Ejemplos de indicaciones
Es bueno indicarle primero a Claude que use LogSeq. Así, siempre llamará a la herramienta.
Ejemplos de indicaciones:
Obtener el contenido de mis últimas notas de reunión y resumirlas
Busque todas las páginas donde se menciona el Proyecto X y explique el contexto
Crea una nueva página con las notas de la reunión de hoy
Actualizar la página de estado del proyecto con las últimas actualizaciones
Related MCP server: Logseq MCP Server
Configuración
Configuración de la API de LogSeq
Puede configurar el entorno con la configuración de la API de LogSeq de dos maneras:
Agregar a la configuración del servidor (preferible)
{
"mcp-logseq": {
"command": "uvx",
"args": [
"mcp-logseq"
],
"env": {
"LOGSEQ_API_TOKEN": "<your_api_token_here>",
"LOGSEQ_API_URL": "http://localhost:12315"
}
}
}Cree un archivo
.enven el directorio de trabajo con las variables requeridas:
LOGSEQ_API_TOKEN=your_token_here
LOGSEQ_API_URL=http://localhost:12315Desarrollo
Edificio
Para preparar el paquete para su distribución:
Sincronizar dependencias y actualizar archivo de bloqueo:
uv syncDepuración
Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una mejor experiencia de depuración, recomendamos usar el Inspector MCP .
Puede iniciar el Inspector MCP a través de npm con:
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-logseq run mcp-logseqAvailable Tools
17 toolscreate_pageA
Create a new page in Logseq with properly structured blocks.
Fails if a page with the same title already exists (use update_page to modify existing pages). This makes retries safe: re-sending a create_page that timed out will not create numbered duplicates like "Page(1)".
Markdown content is automatically parsed into Logseq's block hierarchy:
Headings (# ## ###) create nested sections
Lists (- or 1.) become proper block trees
Code blocks are preserved as single blocks
YAML frontmatter (---) becomes page properties
Example content:
---
tags: [project, active]
priority: high
---
# Project Title
Introduction paragraph.
## Tasks
- Task 1
- Subtask A
- Task 2Inputs: title (required), content, properties.
delete_blockB
Delete a block from LogSeq by its UUID.
Inputs: block_uuid (required).
delete_pageB
Delete a page from LogSeq.
Inputs: page_name (required).
find_pages_by_propertyA
Find all pages that have a specific property, optionally filtered by value. Simpler alternative to the full query DSL.
Inputs: property_name (required), limit, property_value.
get_blockA
Get a single block by its UUID. Returns the block content, properties, and child blocks (recursively). Useful for inspecting a specific block after finding its UUID via search or query.
Inputs: block_uuid (required), format, include_children.
get_page_backlinksB
Get all pages and blocks that link to a specific page (backlinks/linked references).
Inputs: page_name (required), include_content.
get_page_contentB
Get the content of a specific page from LogSeq.
Inputs: page_name (required), format, max_depth, resolve_refs.
get_pages_from_namespaceA
Get all pages within a namespace hierarchy (flat list). Use this to discover subpages of a parent page.
Inputs: namespace (required).
get_pages_tree_from_namespaceA
Get pages within a namespace as a hierarchical tree structure. Useful for understanding the full page hierarchy.
Inputs: namespace (required).
insert_nested_blockA
Insert a new block as a child or sibling of an existing block, enabling nested hierarchical structures
Inputs: content (required), parent_block_uuid (required), sibling, properties.
list_pagesA
Lists all pages in a LogSeq graph, each with its last-updated time (UTC). To find recently modified pages, use sort='updated' (most recent first) and/or updated_since.
Inputs: sort, limit, updated_since, include_journals.
queryB
Execute a Logseq DSL query to search pages and blocks. Supports property queries, tag queries, task queries, and logical combinations. Raw datalog ({:query ...} / [:find ...]) is not supported. See https://docs.logseq.com/#/page/queries for query syntax.
Inputs: query (required), limit, format, result_type.
rename_pageA
Rename an existing page. All references throughout the graph will be automatically updated.
Inputs: new_name (required), old_name (required).
searchC
Search for content across LogSeq pages, blocks, and files
Inputs: query (required), limit, format, include_files, +2 more.
set_block_propertiesA
Set properties on a block in Logseq DB-mode. Properties must be defined on the block's tag/class. Use property display names (e.g. 'Content status', not the internal ident).
Inputs: block_uuid (required), properties (required).
update_blockB
Update the content of an existing LogSeq block by UUID.
Inputs: content (required), block_uuid (required).
update_pageA
Update a page in Logseq with new content and/or properties.
Supports two modes:
append: Add new blocks after existing content (default)
replace: Clear all existing blocks and add new content
Markdown is parsed into proper block hierarchy just like create_page. YAML frontmatter in content will be merged with explicit properties.
Inputs: page_name (required), mode, content, properties.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Each tool targets a distinct resource and action: pages, blocks, search/query, namespaces, and properties. Overlaps like query vs find_pages_by_property are explicitly framed as simple alternatives, so an agent can choose correctly.
Mostly consistent verb_noun snake_case (list_pages, get_block, create_page), but 'query' and 'search' are bare verbs, a minor deviation from the pattern.
17 tools is slightly above the ideal 3-15 range for a cohesive set, though each covers a distinct operation. The count feels a bit heavy but not excessive for LogSeq's complexity.
Core CRUD for pages and blocks is covered, plus searching, querying, backlinks, and namespace navigation. Minor gaps remain (e.g., explicit block creation on a page, move/reorder operations), but agents can work around them.
Maintenance
Related MCP Connectors
Query your app's logs, metrics and incidents from your AI assistant.
Search, read, and safely update Markdown notes in your connected Phasoric knowledge vaults.
Notes, kanban tasks, and a capture inbox: read and create Flow data with a personal token.
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with your local Logseq knowledge base through advanced search, content creation, template management, and knowledge organization with privacy-first, local-only operations.23 npm7MIT
- AlicenseBqualityCmaintenanceEnables AI assistants like Claude to directly read, write, search, and navigate your local Logseq knowledge graph, including managing journals, pages, backlinks, and page relationships without manual copy-pasting.1110 npm6MIT
- AlicenseNot gradedqualityDmaintenanceEnables external AI assistants to interact with Logseq graphs through 34 specialized tools for managing pages, blocks, journals, and tasks via the local HTTP API.MIT
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to Logseq knowledge graphs to read, write, and search pages, blocks, and journals via the Model Context Protocol. It features 17 tools for full graph management, including CRUD operations, batch block insertion, and full-text search.23 npmApache 2.0