siyuan-mcp-sisyphuslisted
Install: claude install-skill yangtaihong59/siyuan-plugins-mcp-sisyphus
# SiYuan MCP Sisyphus
8 aggregated MCP tools for SiYuan note operations. Each tool takes an `action` parameter. Full parameter schemas are in the tool descriptions; use `action="help"` on any tool for detailed guidance.
## Recommended Workflow
1. **Explore**: `notebook(action="list")`, `system(action="get_version")`
2. **Locate**: `document(action="get_path" | "get_hpath" | "get_ids")`
3. **Write**: `document(action="create" | "rename" | "move")`, `block(action="append" | "update" | ...)`
4. **Verify**: `document(action="get_child_blocks")` or `block(action="get_children")`
## Getting Help
- Call any tool with `action="help"` to get its actions, required fields, hints, and examples.
- MCP resources are also available if your client supports them:
- `siyuan://help/tool-overview` — all tools, enabled actions, and guidance
- `siyuan://help/document-path-semantics` — path type details with examples
- `siyuan://help/examples` — minimal call examples for common actions
- `siyuan://help/ai-layout-guide` — layout and block-type decision rules
- `siyuan://help/action/{tool}/{action}` — per-action parameter shapes
## Disabled-by-Default Actions
These actions return `{error: {type: "action_disabled"}}` unless enabled in SiYuan plugin settings.
| Tool | Action |
|------|--------|
| notebook | `remove` |
| notebook | `set_permission` |
| document | `remove` |
| block | `delete` |
## Permission System
Four levels per notebook: `rwd` (read/write/delete), `rw` (read/write