SiYuan MCP — Sisyphus

What it does

Provides a comprehensive operations reference for SiYuan note-taking via an MCP server or standalone CLI (Sisyphus). It documents 10 aggregated tools (notebook, document, block, av, search, file, tag, system, flashcard, mascot), mapping MCP action parameters to CLI commands and detailing permission models, path semantics, and dangerous actions requiring explicit confirmation.

When to use it

Use this skill when the agent needs to interact programmatically with a SiYuan instance: creating or moving documents, editing blocks, managing attribute-view databases, searching content, exporting files, or controlling flashcards/mascot features. Also useful for troubleshooting permission issues or CLI/MCP entrypoint differences.

What's included

• Scripts: none bundled in skill directory (has_scripts=false).
• References: in-skill guidance and examples for MCP and CLI; external package.json/README likely present at repo root.
• Instructions: clear action examples, CLI flags vs MCP parameters mapping, confirmation rules for destructive actions, and pitfalls for AV/database updates.

Compatible agents

Agents that can call MCP tools or shell/CLI commands (MCP-capable assistants, CLI automation agents like Copilot/Gemini CLI).