Menu
Integrate with Logseq PKM - read/write journals, pages, blocks
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | logseq |
| description | Integrate with Logseq PKM - read/write journals, pages, blocks |
| version | 1.0.0 |
| author | Logseq Hermes Integration |
| license | MIT |
| platforms | ["macos","linux"] |
| metadata | {"hermes":{"tags":["knowledge-management","productivity","logseq"],"config":[{"key":"logseq.graph_path","description":"Path to your Logseq graph folder","prompt":"Enter the path to your Logseq graph:","default":"~/Documents/logseq","required":true}]}} |
A Hermes skill for reading from and writing to Logseq personal knowledge management (PKM) graphs. Enables Hermes to expand on notes captured in Logseq — on demand or via scheduled cron jobs.
Hermes can interact with your Logseq graph in two ways:
Install the skill:
skills install logseq
Configure your graph path when prompted:
Enter the path to your Logseq graph: ~/Documents/logseq
Verify installation:
skills list
Your Logseq graph should contain:
logseq-graph/
├── journals/ # Daily journal files (YYYYMMDD.md)
├── pages/ # Named pages (*.md)
| Key | Description | Default |
|---|---|---|
logseq.graph_path | Path to your Logseq graph | ~/Documents/logseq |
| Key | Description | Example |
|---|---|---|
cron.schedule | Cron expression | 0 9 * * * |
cron.operation | Operation to run | append_journal |
cron.output_destination | Where to write | journal |
cron.content | Content template | {{insights}} |
Read today's journal
Returns: Full content of today's journal file with frontmatter properties and body text.
Read journal for 2025-04-24
Date format: YYYY-MM-DD
Read page "Project Notes"
List all pages
Returns: Array of page names in your graph.
Search for "API"
Returns: Matching pages with content snippets showing context.
Append to journal: Remember to follow up on the API integration
The content is appended as an indented block under the last entry.
Create page "Meeting Notes"
Creates pages/meeting_notes.md with title:: Meeting Notes frontmatter.
Append to page "Project Notes": Next steps are to test the integration
Add to config.yaml:
cron:
schedule: "0 9 * * *"
operation: append_journal
output_destination: journal
content: "Daily insight: {{summary}}"
┌───────────── minute (0-59)
│ ┌─────────── hour (0-23)
│ │ ┌───────── day of month (1-31)
│ │ │ ┌─────── month (1-12)
│ │ │ │ ┌───── day of week (0-6)
* * * * *
Examples:
0 9 * * * — Daily at 9:00 AM0 8 * * 1-5 — Weekdays at 8:00 AM0 */2 * * * — Every 2 hours| Error | Cause | Solution |
|---|---|---|
| Graph path not found | Invalid path | Verify logseq.graph_path points to valid directory |
| Journal not found | Date doesn't exist | Try a different date or create first |
| Page not found | Page doesn't exist | Create the page first or check spelling |
| Permission denied | Can't write to directory | Check file permissions |
Location: journals/YYYYMMDD.md
Format:
title:: Daily Note
date:: 2026-04-24
public:: false
tags:: [[journal]]
- 9:00 AM :: [[Morning routine]]
- [ ] Task 1
- [x] Task 2
Location: pages/{slug}.md
Format:
title:: Page Name
tags:: [[tag1]], [[tag2]]
alias:: Alias
Content starts here...
- First block
- Nested block
Logseq uses key:: value format (not YAML frontmatter):
title:: — Page titledate:: — Journal datetags:: — Tag listalias:: — Page aliases[[Page Name]][[#tag]] or #tag((block-uuid))User asks: "What's in my journal from this week?"
Hermes:
User asks: "Create a note about our API discussion"
Hermes:
pages/api_discussion.mdCron runs daily at 9am:
skills list — Check installed skillsskills info logseq — View skill details.planning/ROADMAP.md for feature roadmap