How anshulbansod2/logseq-mcp works
logseq-mcp is an MCP server that exposes safe, high-level operations on Logseq DB graphs. An AI client invokes registered read or write tools; the graph service applies DB-graph conventions and validation, then uses a single HTTP client to call Logseq’s local API. Reads cover notes, tasks, projects, journals, links, cards, and graph configuration; writes include tasks, notes, projects, queries, links, cards, and guarded soft deletion. The tool-module call links are supported by the SOURCE INDEX; unsampled implementations are represented at module level.
Main entry points: server.py MCP server · writer.py Graph writer · reader.py Graph reader · client.py HTTP client
Components 18
MCP interface
- MCP server
src/logseq_mcp/server.py - Read tools
src/logseq_mcp/tools/read.py - Task tools
src/logseq_mcp/tools/tasks.py - Project tools
src/logseq_mcp/tools/projects.py - Note tools
src/logseq_mcp/tools/notes.py - Link tools
src/logseq_mcp/tools/links.py - Card tools
src/logseq_mcp/tools/cards.py - Query tools
src/logseq_mcp/tools/queries.py - Admin tools
src/logseq_mcp/tools/admin.py
Graph service
- Graph reader
src/logseq_mcp/graph/reader.py - Graph writer
src/logseq_mcp/graph/writer.py - Shared graph primitives
src/logseq_mcp/graph/_base.py - DB conventions
src/logseq_mcp/conventions.py - Tool schemas
src/logseq_mcp/models.py
Logseq integration
- Settings
src/logseq_mcp/config.py - HTTP client
src/logseq_mcp/client.py
Other components
- AI agent
- Logseq desktop API
Connections 27
- AI agent → MCP server: invokes tools
README.md - MCP server → Read tools: registers tools
src/logseq_mcp/server.py - MCP server → Task tools: registers tools
src/logseq_mcp/server.py - MCP server → Project tools: registers tools
src/logseq_mcp/server.py - MCP server → Note tools: registers tools
src/logseq_mcp/server.py - MCP server → Link tools: registers tools
src/logseq_mcp/server.py - MCP server → Card tools: registers tools
src/logseq_mcp/server.py - MCP server → Query tools: registers tools
src/logseq_mcp/server.py - MCP server → Admin tools: registers tools
src/logseq_mcp/server.py - Read tools → Graph reader: calls graph
src/logseq_mcp/tools/read.py - Task tools → Graph writer: calls graph
src/logseq_mcp/tools/tasks.py - Project tools → Graph writer: calls graph
src/logseq_mcp/tools/projects.py - Note tools → Graph writer: calls graph
src/logseq_mcp/tools/notes.py - Link tools → Graph writer: calls graph
src/logseq_mcp/tools/links.py - Card tools → Graph writer: calls graph
src/logseq_mcp/tools/cards.py - Query tools → Graph writer: calls graph
src/logseq_mcp/tools/queries.py - Admin tools → Graph writer: calls graph
src/logseq_mcp/tools/admin.py - MCP server → Graph reader: serves resources
src/logseq_mcp/server.py - Graph reader → Shared graph primitives: inherits primitives
src/logseq_mcp/graph/_base.py - Graph writer → Shared graph primitives: inherits primitives
src/logseq_mcp/graph/_base.py - Graph reader → DB conventions: builds queries
src/logseq_mcp/graph/reader.py - Graph writer → DB conventions: applies rules
src/logseq_mcp/graph/writer.py - Graph reader → Tool schemas: returns schemas
src/logseq_mcp/graph/reader.py - Graph writer → Tool schemas: returns schemas
src/logseq_mcp/graph/writer.py - Shared graph primitives → HTTP client: sends API calls
src/logseq_mcp/graph/_base.py - HTTP client → Settings: uses settings
src/logseq_mcp/client.py - HTTP client → Logseq desktop API: posts requests
src/logseq_mcp/client.py