MCPgee
MCPgee
MCPgeeMCPgee

SiYuan

v1.0.0•Knowledge & Memory•stable

思源笔记MCP / SiYuan MCP Server

siyuanmcpai-integration
Share:
63
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is SiYuan?

SiYuan is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 思源笔记mcp / siyuan mcp server

思源笔记MCP / SiYuan MCP Server

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 思源笔记MCP / SiYuan MCP Server

Use Cases

SiYuan notes integration with AI agents
Manage personal knowledge base
xgq18237

Maintainer

LicenseMIT
Languagejavascript
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

NPM

npx -y siyuan

Manual Installation

npx -y siyuan

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use SiYuan

The SiYuan MCP Server connects AI assistants like Claude to SiYuan Note, a privacy-first personal knowledge management application that stores data locally. It exposes over 49 API tools across 12 modules covering notebooks, documents, blocks, attributes, file management, search, export, templates, and system information. This integration lets you query, create, update, and organise your SiYuan knowledge base through natural language, making it possible to insert research notes, run SQL queries across your vault, or manage document hierarchies without leaving your AI chat interface.

Prerequisites

  • SiYuan Note desktop application installed and running (version with API support)
  • SiYuan API token (found in SiYuan Settings > About > API Token)
  • Node.js 18+ for running the MCP server via npx
  • An MCP-compatible client such as Claude Desktop, Cursor, or VS Code
1

Ensure SiYuan is running with API enabled

Open SiYuan Note on your machine. The local API server runs on port 6806 by default. Go to Settings > About to find and copy your API token.

2

Note your SiYuan connection details

You will need three values: the host (default 127.0.0.1), the port (default 6806), and your API token from the SiYuan settings panel.

3

Test the connection by running the server directly

Run a quick test to confirm the MCP server can reach your SiYuan instance before adding it to your client config.

SIYUAN_HOST=127.0.0.1 SIYUAN_PORT=6806 SIYUAN_TOKEN=your-token npx -y siyuan-mcp@latest
4

Add the server to your MCP client configuration

Open your Claude Desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add the siyuan-mcp entry with your credentials.

{
  "mcpServers": {
    "siyuan-mcp": {
      "command": "npx",
      "args": ["-y", "siyuan-mcp@latest"],
      "env": {
        "SIYUAN_HOST": "127.0.0.1",
        "SIYUAN_PORT": "6806",
        "SIYUAN_TOKEN": "your-api-token-here"
      }
    }
  }
}
5

Restart your MCP client

Restart Claude Desktop or your MCP client application so it picks up the new server configuration. The siyuan-mcp tools will appear in the tool list once connected.

SiYuan Examples

Client configuration

Full Claude Desktop configuration for connecting to a local SiYuan Note instance via siyuan-mcp.

{
  "mcpServers": {
    "siyuan-mcp": {
      "command": "npx",
      "args": ["-y", "siyuan-mcp@latest"],
      "env": {
        "SIYUAN_HOST": "127.0.0.1",
        "SIYUAN_PORT": "6806",
        "SIYUAN_TOKEN": "your-api-token-here"
      }
    }
  }
}

Prompts to try

Natural language prompts you can use once the SiYuan MCP server is connected.

- "List all my SiYuan notebooks"
- "Create a new document called 'Q3 Research Notes' in my Work notebook"
- "Search my SiYuan notes for anything mentioning machine learning"
- "Append a new block to the document about project planning with a summary of today's meeting"
- "Export the document 'API Design' as Markdown"

Troubleshooting SiYuan

Connection refused or timeout errors

Verify SiYuan Note is running and the API is accessible at http://127.0.0.1:6806. You can test this in a browser — if the SiYuan UI loads, the API is active. Check that SIYUAN_PORT matches the port shown in SiYuan's settings.

Authentication errors or 401 responses

Double-check that SIYUAN_TOKEN matches exactly the API token shown in SiYuan Settings > About. Tokens are case-sensitive. Generate a new token in SiYuan if you are unsure.

Tools not appearing in Claude Desktop after config update

Fully quit and relaunch Claude Desktop (not just close the window). On macOS use Cmd+Q, then reopen. Check the MCP log at ~/Library/Logs/Claude/mcp.log for any startup errors.

Frequently Asked Questions about SiYuan

What is SiYuan?

SiYuan is a Model Context Protocol (MCP) server that 思源笔记mcp / siyuan mcp server It connects AI assistants to external tools and data sources through a standardized interface.

How do I install SiYuan?

Install via npm with the command: npx -y siyuan. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with SiYuan?

SiYuan works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is SiYuan free to use?

Yes, SiYuan is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

SiYuan Alternatives — Similar Knowledge & Memory Servers

Looking for alternatives to SiYuan? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.

MemPalace

★ 52.6k

A local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically

Kratos

★ 25.7k

🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.

Context Mode

★ 15.4k

An MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm

Memu

★ 13.7k

Memory for 24/7 proactive agents like OpenClaw.

MemOS

★ 9.3k

MemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u

Everos

★ 5.4k

Build, evaluate, and integrate long-term memory for self-evolving agents.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Knowledge & MemoryBrowse All Servers

Quick Config Preview

{ "mcpServers": { "siyuan": { "command": "npx", "args": ["-y", "siyuan"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use SiYuan?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides