SiYuan FAQs

Question 1

What operations can AI agents perform on SiYuan Notes using this tool?

Accepted Answer

AI agents gain extensive control over SiYuan Notes, including comprehensive notebook management (create, open, rename), flexible document and block operations (create, update, delete, export), direct SQL querying of the database, and managing custom block attributes.

Question 2

How many tools are included in SiYuan MCP?

Accepted Answer

SiYuan MCP provides 22 dedicated MCP tools, covering a wide range of functionalities from detailed notebook and document management to granular block-level operations, database queries, and system notifications.

Question 3

What is SiYuan MCP and how does it work?

Accepted Answer

SiYuan MCP is a local server that uses the Model Context Protocol (MCP) to allow AI agents, such as Claude Code, to directly interact with and manipulate your SiYuan Note data. It acts as a bridge between your AI assistant and your SiYuan notes.

Question 4

Which AI clients are compatible with SiYuan MCP?

Accepted Answer

This MCP service is compatible with all AI clients that support the Model Context Protocol. It offers specific configuration guides for popular clients like Claude Code, Claude Desktop, Cursor, and Codex CLI.

Question 5

What are the requirements to set up SiYuan MCP?

Accepted Answer

To use SiYuan MCP, you need Node.js (version 18 or higher), a locally running SiYuan Note application (typically on port 6806), and your SiYuan API Token, which can be found in SiYuan's settings.

SiYuan

SiYuan

Key Features

Use Cases

Key Features

Use Cases