Let AI read and write your Logseq graph directly via MCP
Ask Codex, Claude Code, or Claude Desktop to "add this to today's journal", "find what I did last week", or "show me all pages linked to this one" - and it just works.
Problem: Logseq is a great PKM tool, but integrating with AI assistants requires constant copy-pasting.
Solution: With this MCP server:
- Claude directly writes to your journal (no copy-paste)
- Search and summarize past entries (maintain context)
- Navigate connections between pages (backlinks, graph)
- Auto-generate daily journals with templates
You: "Summarize today's meeting notes and add them to my journal"
Claude: [writes directly to Logseq via logseq-mcp]
"Done! Added to today's journal. Anything else?"
- Use Logseq as your primary PKM
- Use Codex, Claude Code, or Claude Desktop regularly
- Want to delegate note management to AI
- Use local file-based Logseq (not Logseq Sync)
- Using Logseq Sync (requires local file access)
- Obsidian user (different MCP server needed)
- Have sensitive info in notes and uncomfortable with AI access
- Use org-mode instead of Markdown (not yet supported)
| Feature | Description |
|---|---|
| Page CRUD | Create, read, update, delete pages + property support |
| Search | Full-text search + tag/folder filtering |
| Graph Navigation | Links, backlinks, page relationship traversal |
| Journal | Access today's/specific date journals + templates |
| Content Logging | Log articles, books, movies, exhibitions to journal |
| Resources | Expose graph pages as MCP resources |
Use the published package:
npx -y @dearcloud09/logseq-mcpOr install from a local checkout for development:
git clone https://github.com/dearcloud09/logseq-mcp.git
cd logseq-mcp
npm ci
npm run buildAdd the MCP server to ~/.codex/config.toml:
[mcp_servers.logseq]
command = "npx"
args = ["-y", "@dearcloud09/logseq-mcp"]
[mcp_servers.logseq.env]
LOGSEQ_GRAPH_PATH = "/path/to/your/logseq/graph"Then open Codex and run /mcp to confirm the logseq server is connected.
Claude Code (~/.claude/settings.json):
{
"mcpServers": {
"logseq": {
"command": "npx",
"args": ["-y", "@dearcloud09/logseq-mcp"],
"env": {
"LOGSEQ_GRAPH_PATH": "/path/to/your/logseq/graph"
}
}
}
}Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"logseq": {
"command": "npx",
"args": ["-y", "@dearcloud09/logseq-mcp"],
"env": {
"LOGSEQ_GRAPH_PATH": "/path/to/your/logseq/graph"
}
}
}
}For a local checkout, replace the command with node and the args with
["/absolute/path/to/logseq-mcp/dist/index.js"].
Ask your MCP client: "Show me my Logseq page list"
| Tool | Description |
|---|---|
list_pages |
List all pages with metadata (tags, links, backlinks) |
read_page |
Read page content and metadata |
create_page |
Create new page (with property support) |
update_page |
Update page content |
delete_page |
Delete a page |
append_to_page |
Append content to existing page |
search_pages |
Search by content/title + tag/folder filters |
get_backlinks |
Get pages that reference a specific page |
get_graph |
Get page connection graph data |
get_journal |
Get today's or specific date's journal |
create_journal |
Create journal with optional template |
add_article |
Add article to journal (title, summary, tags, URL, highlights) |
add_book |
Add book to journal (title, author, tags, memo) |
add_movie |
Add movie to journal (title, director, memo) |
add_exhibition |
Add exhibition to journal (title, venue, artist, memo) |
"Show me today's journal"
"Add this content to 'Project A' page: ..."
"Find all pages with #meeting tag"
"What pages are connected to my Goals page?"
"Search for TODO items in last week's journals"
"Create a new page called 'Reading List'"
"Summarize our conversation and save it as an article in my journal"
your-graph/
journals/ # Daily journals (2024_01_15.md format)
pages/ # Regular pages
logseq/ # Logseq settings
whiteboards/ # Whiteboards
- Path traversal protection (graph-only access)
- Symlink/hardlink attack prevention
- Input validation and sanitization
- DoS protection (content size limits)
- Error message sanitization
See SECURITY.md for the full security model.
Set LOGSEQ_GRAPH_PATH in your configuration file.
- Confirm Node.js 20+ is installed
- Confirm
LOGSEQ_GRAPH_PATHis an absolute path (/Users/...format) - In Codex, run
/mcpand check whetherlogseqis listed - For a local checkout, ensure
npm run buildwas executed
- Check if
.mdfiles exist injournals/orpages/ - Verify you're using local graph (not Logseq Sync)
Currently Markdown only. org-mode support planned for future.
This project includes features optimized for Korean users:
Auto-generate daily journal with weather (Korea only - uses Naver Weather) and diary template.
- Copy and edit plist file:
cp com.logseq.daily-automation.plist.example ~/Library/LaunchAgents/com.logseq.daily-automation.plist
# Edit the file to replace /path/to/ with your actual paths- Load launchd agent:
launchctl load ~/Library/LaunchAgents/com.logseq.daily-automation.plist- Test manually:
./run-daily-automation.shGenerated template structure:
- [[일기]]
- [[날씨]]
- {weather info}
- [[오늘의 일기]]
- [[행복도]]
- [[오늘의 행복]]
- [[오늘의 컨디션]]
- [[수면]]
- 취침:
- 기상:
- 질: /5
- [[오늘의 생각]]
- [[Tasks]]
- TODO
- [[오늘 잘 해낸 일]]
- [[TIL]]See Korean README for more details.
add_book, add_movie, add_exhibition tools use Korean wikilink structure ([[문화]]). Customize the templates in src/index.ts for your language.
# Install dependencies
npm ci
# Development mode (watch)
npm run dev
# TypeScript build
npm run build
# Run regression tests
npm test
# Check npm package contents
npm pack --dry-run
# Production run
npm startsrc/
index.ts # MCP server entry point, tool handlers
types.ts # TypeScript type definitions
graph.ts # Graph filesystem operations
Issues and pull requests are welcome. See CONTRIBUTING.md for setup, testing, and contribution guidelines.
- org-mode support
- Logseq property search
- Whiteboard support
- Better graph visualization data
- i18n for templates