siyuan-mcp-sisyphus

What problem does it solve?

SiYuan stores rich note data, but agents often cannot access or manage it safely; this skill surfaces the key MCP tools for notebooks, documents, blocks, files, search, tags, and system actions so you can navigate, edit, and export content without ad hoc API calls.

Core Features & Use Cases

• Aggregates seven MCP tools so agents invoke a single tool name with an action parameter instead of juggling dozens of endpoints.
• Highlights safe path semantics by explaining when to use storage paths versus human-readable paths and instructing you to fetch the storage path from the document get_path action before running path-based operations.
• Calls out disabled-by-default actions such as notebook remove or block delete while summarizing the four permission levels and the required confirmations before destructive moves or deletions.
• Use case: list notebooks, fetch a document path, append content with block append, and export markdown while honoring notebook permissions and avoiding unsafe actions.

Quick Start

Use the SiYuan MCP Sisyphus skill to call the notebook list action before editing any document to ensure you have the correct permissions.