siyuan-sisyphus-cli

Automating SiYuan note operations with MCP tools involves using default workflows to read, write, and organize notes, blocks, and notebooks. Mutations include strict safety checks and read-after-write validation to ensure correctness.

Managing SiYuan blocks and notebooks via automation is best handled through MCP-based workflows for discovery and mutations. This method ensures operations are backed by verification and strict read-after-write validation.

Use the CLI for SiYuan notes only when explicitly requested, when MCP tools are unavailable, when a needed operation is not exposed by MCP, or when scripting against SiYuan is required. The CLI acts as a fallback when MCP coverage is insufficient.

SiYuan MCP automation supports read-after-write verification. Mutations performed through MCP tools include strict safety checks and validation steps to guard against errors and ensure data integrity.

You can use MCP to organize SiYuan assets and tags. The default MCP path streamlines management of notes, blocks, notebooks, attribute views, databases, tags, and assets.

Prefer MCP over CLI for SiYuan note mutations because MCP provides default workflows with built-in safety checks and read-after-write validation. The CLI is only used as a fallback when MCP coverage is insufficient or unavailable.