Siyuan MCP Server

Safe, structured Model Context Protocol server for SiYuan Note

Local serverstdioTypeScript

What is the Siyuan MCP Server?

Safe, structured Model Context Protocol server for SiYuan Note

What you get

siyuan-mcp 是一个基于 Model Context Protocol 的思源笔记 MCP 服务器。它通过思源 Kernel API 提供笔记本、文档、内容块、全文搜索、原生数据库、资源文件和导出等能力,并针对 AI 自动化场景增加了结构化返回、安全注解与默认防护。

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
commandnpx
args["-y", "siyuan-mcp@latest"]
env- SIYUAN_HOST
check_siyuan_statuslist_notebooks
get_version--
nextIDpreviousID
list_notebooks列出所有笔记本及打开状态
create_notebook创建笔记本
rename_notebook重命名笔记本
remove_notebook删除笔记本,属于危险操作
create_doc使用 Markdown 创建文档
search_docs按标题搜索文档
list_docs浏览指定路径下的文档

How to install the Siyuan MCP Server

claude mcp add siyuan --env SIYUAN_HOST=your-value --env SIYUAN_PORT=your-value --env SIYUAN_TOKEN=your-value --env SIYUAN_URL=your-value -- npx -y siyuan-mcp

Configuration

VariableDescriptionRequired
SIYUAN_HOSTEndpoint or connection string the server talks to.Optional
SIYUAN_PORTConfiguration value read at startup.Optional
SIYUAN_TOKENCredential the server authenticates with.Yes
SIYUAN_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • “Use Siyuan to command.”
  • “Use Siyuan to args.”
  • “Use Siyuan to env.”

Frequently asked questions

Safe, structured Model Context Protocol server for SiYuan Note Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.