// MCP TOOL REFERENCE

SIYUAN MCP SERVER TOOLS

52 tools from the SiYuan MCP Server MCP Server, categorised by risk level.

// ALL 52 SIYUAN MCP SERVER TOOLS

READ 18 tools

Read check_siyuan_status 检查思源笔记状态和 API 可用性 Read get_block_attrs 获取块属性 Read get_block_kramdown 获取块 kramdown 源码 Read get_boot_progress 获取启动进度 Read get_child_blocks 获取子块 Read get_current_time 获取系统当前时间 Read get_file 获取文件 Read get_hpath_by_id 根据 ID 获取人类可读路径 Read get_hpath_by_path 根据路径获取人类可读路径 Read get_ids_by_hpath 根据人类可读路径获取 IDs Read get_notebook_conf 获取笔记本配置 Read get_path_by_id 根据 ID 获取存储路径 Read get_version 获取思源笔记版本 Read get_workspace_info 获取工作空间和连接信息 Read list_notebooks 列出所有笔记本 Read read_dir 列出文件 Read export_md_content 导出 Markdown 文本 Read export_resources 导出文件与目录

WRITE 25 tools

Write transfer_block_ref 转移块引用 Write append_block 插入后置子块 Write close_notebook 关闭指定笔记本 Write create_doc 在指定笔记本中新建文档 Write create_notebook 创建新笔记本 Write flush_transaction 提交事务 Write fold_block 折叠块 Write insert_block 插入块 Write move_block 移动块 Write move_docs 移动文档 Write move_docs_by_id 根据ID移动文档 Write open_notebook 打开指定笔记本 Write prepend_block 插入前置子块 Write push_err_msg 推送错误消息 Write push_msg 推送消息 Write put_file 写入文件 Write rename_doc 重命名文档 Write rename_doc_by_id 根据ID重命名文档 Write rename_file 重命名文件 Write rename_notebook 重命名笔记本 Write set_block_attrs 设置块属性 Write set_notebook_conf 保存笔记本配置 Write unfold_block 展开块 Write update_block 更新块 Write upload_asset 上传资源文件

DESTRUCTIVE 5 tools

Destructive delete_block 删除块 Destructive remove_doc 删除文档 Destructive remove_doc_by_id 根据ID删除文档 Destructive remove_file 删除文件 Destructive remove_notebook 删除笔记本

EXECUTE 4 tools

Execute sql_query 执行 SQL 查询 Execute pandoc_convert Pandoc 转换 Execute render_sprig 渲染 Sprig Execute render_template 渲染模板

// FAQ

How many tools does the SiYuan MCP Server MCP server have? +

The SiYuan MCP Server MCP server exposes 52 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on SiYuan MCP Server tools? +

Route the SiYuan MCP Server server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do SiYuan MCP Server tools fall into? +

SiYuan MCP Server tools are categorised as Read (18), Write (25), Destructive (5), Execute (4). Each category has a recommended default policy.

Enforce policy on every SiYuan MCP Server tool call.

Deterministic rules across all 52 SiYuan MCP Server tools. Per-identity grants. Full audit log. Live in minutes. Nothing to install.

GOVERN SIYUAN →

Free to start. No card required.

42,500+ MCP servers and 110,000+ tools scanned and risk-classified.