siyuan-skill

Orchestrate SiYuan MCP tools through OpenClaw workflows for repeatable note operations.

7|3|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/PurpleLiu/siyuan-mcp --skill siyuan-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: siyuan-skill
Source: https://github.com/PurpleLiu/siyuan-mcp/tree/main/skills/siyuan-skill
Command: npx skills add https://github.com/PurpleLiu/siyuan-mcp --skill siyuan-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenClaw workflows for SiYuan MCP are fragmented and tightly coupled to MCP internals. This Skill decouples tool orchestration from internal implementations, enabling repeatable, safe workflows across SiYuan Note via MCP.

Core Features & Use Cases

  • MCP-tool orchestration: Define end-to-end workflows that chain MCP tools (search, read, write, organize) through OpenClaw.
  • Environment-driven safety: Enforces required environment variables and separation of concerns to prevent misconfigurations and data leakage.
  • Workflow templates: Provides reusable patterns for common SiYuan note-management tasks such as indexing, daily notes, and retrieval.
  • Non-intrusive integration: Describes how to compose actions without exposing internal MCP workings.

Quick Start

Use mcporter to call siyuan.<tool> key=value to invoke a tool in the siyuan MCP server (requires SIYUAN_TOKEN and SIYUAN_BASE_URL).

Frequently Asked Questions about siyuan-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate SiYuan note management workflows through MCP?

To automate SiYuan note management, this Skill orchestrates MCP workflows by chaining search, read, write, and organize tools through OpenClaw. It decouples tool orchestration from internal implementations, enabling repeatable and safe note operations.

What environment variables do I need to run SiYuan MCP workflows safely?

Running SiYuan MCP workflows safely requires explicit environment variables including SIYUAN_TOKEN and SIYUAN_BASE_URL. This environment-driven safety approach enforces separation of concerns to prevent misconfigurations and data leakage.

Can I chain multiple MCP tools together for SiYuan note operations?

Yes, you can chain multiple MCP tools together for SiYuan note operations. The Skill defines end-to-end workflows that assemble sequences of MCP tools such as search, read, write, and organize, then write results back into SiYuan notes.

How do I invoke a specific tool in the SiYuan MCP server using OpenClaw?

To invoke a specific tool in the SiYuan MCP server, use mcporter to call siyuan.<tool> with key=value parameters. This non-intrusive integration composes actions without exposing internal MCP workings.

Are there reusable templates for common SiYuan note tasks?

Yes, there are reusable templates for common SiYuan note tasks. The Skill provides workflow templates for note-management patterns such as indexing, daily notes, and retrieval, making orchestration repeatable across different scenarios.

Why decouple OpenClaw workflows from SiYuan MCP internal implementations?

Decoupling OpenClaw workflows from SiYuan MCP internal implementations prevents tight coupling and fragmentation. This separation of concerns enables repeatable, safe workflows across SiYuan Note via MCP without exposing internal workings to the orchestration layer.