Logseq
Outliner knowledge graph whose desktop app embeds an MCP server over its local HTTP API.
Logseq is a privacy-first outliner for journals, pages, and block references, with a plugin API and a DB-graph version in development. The Electron app includes an MCP server (src/electron/electron/mcp_server.cljs) that fronts the local API server with page, tag, property, block-search, and upsert tools. AGPL; no config surface beyond per-graph settings, so it is listed as Operable only.
- you live in daily journals with block references and want an agent to search and append to your graph
- you want a local-first outliner with a plugin ecosystem and no account
- AGPL-3.0
- The MCP server is on master (DB version); confirm it ships in the stable 0.10.x file-graph builds
- The local HTTP API server must be enabled in settings with a token before MCP tools work
- One tool is annotated 'must be called at most once per user request'
Last activity Sep 3, 2026. Fit: adaptable 1, operable 2.
Operable: what an agent can drive
Interface
OfficialMCP serverpublished by the builderlocal
How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.
Reach
Partial coverage. 4 of 9 jobs reachable through the stated interface.
| Job | Through the interface | Evidence |
|---|---|---|
| Read a page | Reachable | api-get-page in mcp_server.cljs |
| List pages, tags, and properties | Reachable | api-list-pages, api-list-tags, api-list-properties |
| Search blocks | Reachable | api-search-blocks |
| Create and update pages and blocks | Reachable | api-upsert-nodes |
| Journals | Undetermined | journal pages are pages; upsert to today's page not verified |
| Delete pages or blocks | Not reachable | no delete tool in api-tools |
| Datalog and advanced queries | Not reachable | no query tool; the HTTP API's logseq.DB.q is not exposed |
| Whiteboards and flashcards | Not reachable | UI features; no tool |
| Sync and real-time collaboration | Not reachable | DB-version RTC is a separate service |
Code stack
- Languages
- ClojureClojureScriptTypeScript
- Frameworks
- ElectronDataScript
- Package manager
- yarn
- Database
- DataScript (in-memory)SQLite (DB version)
- Hosting target
- binary
- Built
- Mixed (recorded, never ranked)
Skills
Developer tooling for people working on the Logseq repo (CLI maintenance, REPL, i18n, dependency upgrades), not skills an Adopter's agent uses.
- Kind
- contributor
- Paths
.agents/skills/*/SKILL.md
Evidence and confidence
| Field | Where it was seen | Confidence |
|---|---|---|
| formFactor | README: desktop app for macOS, Windows, Linux; mobile apps separate | 95% |
| executionModel | no model in the app | 90% |
| operability | src/electron/electron/mcp_server.cljs in logseq/logseq registers api-tools over the API server | 85% |
| effort | per-graph config.edn and custom.css are user settings; changing the app is a Clojure fork under AGPL, so Adaptable is not claimed | 70% |
| editions | AGPL, free; paid sync status unclear | 70% |
| active | pushedAt 2026-09-03 | – |
| provenance | AGENTS.md at root; project from 2020 | 40% |
| reach | 80% |
Open questions
- Is Logseq Sync a paid edition today, and at what price?
- Is the MCP server in a released build? If not, ergut/mcp-logseq (324 stars per triage) would be the Recommended wrapper with dailydaniel/logseq-mcp (41 stars, 2026-07-08) as runner-up
- Whether config.edn counts as a Customization surface for the Curator
Sources
- github.com/logseq/logseq sourcing:notes-knowledge:curated
- github.com/logseq/logseq/blob/master/src/electron/electron/mcp_server.cljs analysis