SiYuan MCP — Sisyphus

Trust Score 81/100

Toolset for operating SiYuan notes via MCP or CLI: notebook/document/block/av/search/file/tag/flashcard/mascot, with path semantics, permissions, and safe actio

triggers:siyuansiyuan-sisyphusmcpsiyuan pluginblock appenddocument createav add_rowsflashcardexport resources

GitHub SKILL.md

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).

Audit Summary

SiYuan MCP Sisyphus is a CLI-first skill for operating SiYuan notes via MCP or CLI. No bundled scripts were present for execution testing. The SKILL.md is well-written with clear bootstrap instructions, command reference, pagination guidance, and a safety section listing high-risk actions. The skill relies on a locally-installed `siyuan-sisyphus` CLI binary and a running SiYuan instance.

Watch Out

Requires siyuan-sisyphus CLI binary pre-installed
Token passed via --token flag could leak to shell history
Source path in DB (skills/siyuan-mcp-sisyphus/SKILL.md) does not match actual repo path (skills/siyuan-sisyphus/siyuan-sisyphus/SKILL.md)

Notes

Skill slug 'siyuan-mcp-sisyphus' in DB doesn't match the actual directory name 'siyuan-sisyphus' in the repo, causing the source_url to 404. The SKILL.md itself is high quality — comprehensive, well-organized, with good safety guidance. No security concerns found.

Information

Repository: siyuan-plugins-mcp-sisyphus
Stars: 19
Installs: 0

Trust Score

Overall81

Security92

Code Quality72

Architecture68

Usefulness55

Related Skills

Development Worktree

Create an isolated git worktree for feature work, auto-run project setup, and verify a clean test baseline before development.

Readwise Reader Document Management

Manage Readwise Reader documents: list, save, search, move, tag, highlight, export and bulk-edit via official and custom CLIs.

Bounty Hunter — Atlas

Persona skill: 'Atlas' — a profit-focused developer persona for discovering, evaluating and executing paid bounties or freelance tasks with ROI-aware workflows.

Full Stack Builder

End-to-end builder that scaffolds, implements, tests, and optionally deploys web and API applications from a natural-language specification.

ezBookkeeping API Tools

Command-line API tools for ezBookkeeping: record and query transactions, retrieve accounts/categories/tags, and fetch exchange rates for self-hosted personal fi

Feishu Voice Sender

Convert MP3s and send them as native Feishu voice messages (playable voice clips) to users or groups.

Claw Bench

Benchmarking skill that guides an agent through a structured suite of capability tests and reporting steps for leaderboard submission.

StateTree Behavior

Tools to create, inspect, and edit Unreal Engine StateTree assets (hierarchical state machines) and Blueprint task workflows.

Back to Skills