SiYuan MCP Server
MCP server for SiYuan Note — a privacy-first, local-first personal knowledge management system with powerful block-based editing and bidirectional linking. Enables AI agents to read and write SiYuan notes, query the knowledge graph, search content, and integrate SiYuan PKM into AI-driven productivity workflows.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
Personal knowledge base. API token auth. Local data — sensitive personal notes. No cloud exposure unless SiYuan sync enabled.
⚡ Reliability
Best When
A SiYuan user wants AI agents to read, write, and search their personal knowledge base — automating note creation, content retrieval, and knowledge graph queries.
Avoid When
You use Obsidian, Notion, or another PKM. SiYuan has a specific local API — this MCP is SiYuan-only.
Use Cases
- • Reading and searching SiYuan notes from research and writing agents
- • Creating and updating notes in SiYuan from productivity agents
- • Querying knowledge graph links and backlinks from analysis agents
- • Integrating SiYuan PKM with AI workflows for automated note-taking
Not For
- • Obsidian users (use Obsidian MCP instead)
- • Notion/Roam users (different PKM systems)
- • Cloud-first note-taking without SiYuan installed
Interface
Authentication
SiYuan local API token required. Configure in SiYuan Settings > About > API Token.
Pricing
SiYuan is free for local use. MCP server is free open source community tool.
Agent Metadata
Known Gotchas
- ⚠ Requires SiYuan running locally with API enabled — not a cloud service
- ⚠ SiYuan's block-based structure is unique — agents need to understand the data model
- ⚠ Community tool — not official SiYuan integration from B3log team
- ⚠ SiYuan API may change between versions — pin to compatible SiYuan release
Alternatives
Full Evaluation Report
Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for SiYuan MCP Server.
Scores are editorial opinions as of 2026-03-06.