graphthulhu
MCP server that gives you full access to a Logseq or Obsidian knowledge graph. 37 tools across 9 categories: navigate, search, analyze, write, decisions, journals, flashcards, whiteboards, and health.
Install
Download the binary for your platform from GitHub Releases and put it on your PATH.
Or: go install github.com/skridlevsky/graphthulhu@latest
Configure
Obsidian
Add to your MCP settings:
{
"mcpServers": {
"graphthulhu": {
"command": "graphthulhu",
"args": ["--backend", "obsidian", "--vault", "/path/to/your/vault"]
}
}
}
No plugins required. Reads .md files directly. Full read-write support.
Logseq
Enable the HTTP API server in Logseq (Settings > Features > HTTP APIs server), start it, and create a token.
{
"mcpServers": {
"graphthulhu": {
"command": "graphthulhu",
"env": {
"LOGSEQ_API_URL": "http://127.0.0.1:12315",
"LOGSEQ_API_TOKEN": "your-token-here"
}
}
}
}
What you can do
- Navigate — get pages with full block trees, traverse the link graph, list pages by namespace/tag/property
- Search — full-text search with context, property queries, tag hierarchy search, raw Datalog (Logseq)
- Analyze — graph overview, find connections between pages, detect knowledge gaps and orphans, discover topic clusters
- Write — create pages, append/upsert blocks with nested children, update/delete/move blocks, link pages bidirectionally, rename pages with link updates, bulk update properties
- Decisions — create decisions with deadlines, check status, resolve or defer with tracking
- Journals — read entries by date range, search within journals
- Flashcards — SRS stats, due cards, create new cards (Logseq)
- Whiteboards — list and inspect spatial canvases (Logseq)
Links
1---2name: graphthulhu3description: Knowledge graph MCP server for Logseq and Obsidian. 37 tools for reading, writing, searching, and analyzing your second brain.4---5
6# graphthulhu
7
8MCP server that gives you full access to a Logseq or Obsidian knowledge graph. 37 tools across 9 categories: navigate, search, analyze, write, decisions, journals, flashcards, whiteboards, and health.
9
10## Install
11
12Download the binary for your platform from [GitHub Releases](https://github.com/skridlevsky/graphthulhu/releases) and put it on your PATH.
13
14Or: `go install github.com/skridlevsky/graphthulhu@latest`
15
16## Configure
17
18### Obsidian
19
20Add to your MCP settings:
21
22```json
23{
24 "mcpServers": {
25 "graphthulhu": {
26 "command": "graphthulhu",
27 "args": ["--backend", "obsidian", "--vault", "/path/to/your/vault"]
28 }
29 }
30}
31```
32
33No plugins required. Reads `.md` files directly. Full read-write support.
34
35### Logseq
36
37Enable the HTTP API server in Logseq (Settings > Features > HTTP APIs server), start it, and create a token.
38
39```json
40{
41 "mcpServers": {
42 "graphthulhu": {
43 "command": "graphthulhu",
44 "env": {
45 "LOGSEQ_API_URL": "http://127.0.0.1:12315",
46 "LOGSEQ_API_TOKEN": "your-token-here"
47 }
48 }
49 }
50}
51```
52
53## What you can do
54
55- **Navigate** — get pages with full block trees, traverse the link graph, list pages by namespace/tag/property
56- **Search** — full-text search with context, property queries, tag hierarchy search, raw Datalog (Logseq)
57- **Analyze** — graph overview, find connections between pages, detect knowledge gaps and orphans, discover topic clusters
58- **Write** — create pages, append/upsert blocks with nested children, update/delete/move blocks, link pages bidirectionally, rename pages with link updates, bulk update properties
59- **Decisions** — create decisions with deadlines, check status, resolve or defer with tracking
60- **Journals** — read entries by date range, search within journals
61- **Flashcards** — SRS stats, due cards, create new cards (Logseq)
62- **Whiteboards** — list and inspect spatial canvases (Logseq)
63
64## Links
65
66- [GitHub](https://github.com/skridlevsky/graphthulhu)
67- [Full tool reference](https://github.com/skridlevsky/graphthulhu#tools)
modbender