{"id":"ergut-mcp-logseq","name":"mcp-logseq","homepage":null,"repo_url":"https://github.com/ergut/mcp-logseq","category":"ai-ml","subcategories":[],"tags":["mcp","logseq","python","local-first","knowledge-management","semantic-search","vector-search"],"what_it_does":"Provides an MCP server that lets an AI assistant interact with your LogSeq knowledge base via LogSeq's local HTTP API. It supports reading, creating, updating, deleting pages/blocks, searching pages/content, executing Logseq DSL queries, and (optionally) semantic vector search and DB-mode property operations.","use_cases":["Read and summarize LogSeq pages or namespaces","Create or update LogSeq pages from structured requests (including markdown-to-block conversion)","Manage task lists by inserting/updating blocks and properties","Search across a LogSeq graph using keyword/DSL and optional vector similarity","Maintain a vector index locally (sync and health checks)","Use DB-mode graphs to set class properties on blocks/pages (beta/opt-in)"],"not_for":["Handling sensitive data in environments where local network access to the LogSeq HTTP API is not acceptable","Teams that require strong formal guarantees about error recovery, idempotency, and backward compatibility (release notes not provided here)","Scenarios needing cloud-hosted, multi-tenant access control or managed authentication"],"best_when":"You run LogSeq locally and want an agent to automate knowledge work directly against your own graph, optionally with local semantic search.","avoid_when":"You cannot securely provide/guard an API token for LogSeq's HTTP server, or you need highly reliable transactional/idempotent behavior for repeated writes without duplicates.","alternatives":["Write direct integrations against LogSeq’s HTTP API with your own tooling","Use LogSeq export/import or manual workflows for small tasks (no agent integration)","Custom semantic search pipeline using Ollama embeddings + LanceDB (without MCP orchestration)"],"af_score":58.5,"security_score":44.0,"reliability_score":36.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:36:35.400866+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["LogSeq HTTP API token (LOGSEQ_API_TOKEN) passed via environment variable"],"oauth":false,"scopes":false,"notes":"Authentication is delegated to LogSeq’s local HTTP API via an API token. The README does not describe fine-grained scopes or token permissions."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Self-hosted open-source package; costs are local (compute/storage) plus any embeddings runtime (e.g., Ollama) if using vector search."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":["Local-only (intended): uses LogSeq local HTTP API and optional local embeddings (no data leaves machine per README claims)"],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":58.5,"security_score":44.0,"reliability_score":36.2,"mcp_server_quality":80.0,"documentation_accuracy":75.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":70.0,"rate_limit_clarity":10.0,"tls_enforcement":30.0,"auth_strength":55.0,"scope_granularity":20.0,"dependency_hygiene":55.0,"secret_handling":60.0,"security_notes":"Uses a LogSeq API token provided via env var. TLS enforcement and secret logging behavior are not described; local HTTP is implied (http://localhost). No evidence of fine-grained scopes, rate-limit headers, or robust structured security error messages in the provided README.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":50.0,"error_recovery":40.0,"idempotency_support":"false","idempotency_notes":"No idempotency or deduplication guarantees are described for write operations (create/update/insert/delete). Repeated requests may create duplicates depending on how the MCP tools are implemented.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Requires LogSeq HTTP APIs server to be started and a token generated; otherwise calls will fail.","Vector search tools require additional setup (VECTOR_SEARCH.md).","DB-mode property tools are opt-in and only applicable to LogSeq DB-mode graphs.","MCP client environment must correctly run the server (e.g., uv availability/path on Claude Desktop)."]}}