siyuan-mcp

Connect AI tools to SiYuan Note via MCP for note search and organization.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables integration of AI tools with SiYuan Note through MCP to enable safe search, reading, and organization of notes across clients.

Core Features & Use Cases

  • MCP-based integration: Connect AI workflows with SiYuan Note for querying, extracting, and organizing content.
  • Safe access and management: Provide controlled access to documents, blocks, and notebooks via MCP.
  • Cross-client automation: Automate repetitive note-management tasks across different MCP clients.

Quick Start

Start the MCP server with your token and base URL to begin connecting AI tools to SiYuan Note.

Frequently Asked Questions about siyuan-mcp

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

FAQPage Schema
How do I connect AI tools to SiYuan Note for automated searching and reading?

You connect AI tools to SiYuan Note by using an MCP server that provides safe access to search, read, and organize documents, blocks, and notebooks across different clients.

What do I need to configure to start the MCP server for SiYuan integration?

To start the MCP server for SiYuan integration, you need to configure your authorization token and base URL, enabling the connection between your AI workflows and SiYuan Note.

Does the SiYuan MCP integration support both HTTP and STDIO transports?

Yes, the SiYuan MCP integration provides a TypeScript-based server that supports both HTTP and STDIO transports to facilitate cross-client automation and note management.

Can I automate daily note management and notebook traversal across multiple MCP clients?

Yes, you can automate repetitive note-management tasks like notebook traversal and daily notes management across multiple MCP clients through controlled MCP-based access.

What is the best way to safely extract and organize content from SiYuan blocks using AI?

The best way to safely extract and organize SiYuan block content is by using an MCP server to provide controlled, token-authenticated access for your AI tools to query and manage notes.

Why should I use MCP instead of direct API calls for SiYuan Note automation?

Using MCP for SiYuan Note automation provides a standardized, safe integration layer across multiple clients, ensuring controlled access to documents and blocks without direct API management.