AgentToolHub
Skill

siyuan-skill

siyuan-skill — a Claude Code skill from purpleliu/siyuan-mcp

Features

  • ✓**66 tools** covering search, documents, blocks, notebooks, daily notes, snapshots, and tags
  • ✓**Unified search** — content, filename, tag, or combined filters
  • ✓**Document tree** — browse notebook hierarchy by depth
  • ✓**Daily notes** — auto-create today’s note if it doesn’t exist
  • ✓**Snapshot management** — create/list/rollback
  • ✓**Stdio & HTTP** transports
  • ✓**TypeScript** full type definitions

Installation Guide

bash
git clone https://github.com/PurpleLiu/siyuan-mcp.git
cd siyuan-mcp
npm install && npm run build
npm install -g .

Get Your SiYuan API Token

SiYuan → Settings → About → API Token

Environment Variables (optional)

bash
export SIYUAN_TOKEN=your-token
export SIYUAN_BASE_URL=http://127.0.0.1:6806
export SIYUAN_VERBOSE=1   # optional

Configure Your MCP Client

Cursor (~/.cursor/mcp.json):

json
{
  "mcpServers": {
    "siyuan": {
      "command": "siyuan-mcp",
      "args": ["stdio", "--token", "YOUR_TOKEN", "--baseUrl", "http://127.0.0.1:6806"]
    }
  }
}

Claude Desktop (claude_desktop_config.json):

json
{
  "mcpServers": {
    "siyuan": {
      "command": "siyuan-mcp",
      "args": ["stdio", "--token", "YOUR_TOKEN", "--baseUrl", "http://127.0.0.1:6806"]
    }
  }
}

Config locations:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

    • Reviews