SiYuan Note MCP Server

@MCP-Mirror

Repository

Basic information

About SiYuan Note MCP Server

Mirror of

#mcp-server#si-yuan-note#note-management

SiYuan Note MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "onigeya_siyuan-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "\\"
      ]
    }
  }
}

SiYuan Note MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is SiYuan Note MCP Server?

SiYuan Note MCP Server is an MCP server implementation that integrates with the SiYuan Note system, enabling AI models to access and manipulate note data. It provides a command‑based interface for notebooks, documents, blocks, files, assets, SQL queries, attributes, exports, and system functions.

How to use SiYuan Note MCP Server?

Configure a SIYUAN_TOKEN environment variable with the SiYuan API token (found in SiYuan Note Settings > About). Add the server to Claude Desktop’s claude_desktop_config.json using npx -y @onigeya/siyuan-mcp-server, or run locally with pnpm start after installing dependencies. A Docker image is also available.

Key features of SiYuan Note MCP Server

Notebook and document management (create, rename, delete, move)
Content block operations (insert, update, delete, move)
File and asset upload/manipulation
SQL and full‑text search queries
Attribute management (set and get block attributes)
Export and format conversion (Pandoc support)

Use cases of SiYuan Note MCP Server

AI agents reading, writing, or reorganizing notes in SiYuan
Automating notebook structure and document creation from markdown
Searching and querying note content programmatically
Integrating SiYuan with external workflows via file and asset operations

Frequently asked questions

What dependencies or runtime are required?

Node.js >= 23.10.0 and pnpm are required for local builds. A Docker image is also provided.

How is authentication handled?

The server requires a `SIYUAN_TOKEN` environment variable, which is the API token from SiYuan Note. It is used for API authentication.

What transports or protocols does it use?

The README does not specify transport details; it is an MCP server (presumably stdio for Claude Desktop) but no explicit transport is mentioned.

Can it execute arbitrary SQL on the SiYuan database?

Yes, it provides `query.sql` and `sql.sql` commands to execute SQL queries against the SiYuan note database.

Where does the data live?

Data is stored within the SiYuan Note system; the server accesses it via SiYuan’s API. No data is stored by the server itself.

Comments

More Memory & Knowledge MCP servers

OpenLore

aakarim

Serve your docs to AI agents over SSH and MCP. Agents use ls, cat, grep, find, and pipes against a virtual filesystem backed by your documentation. Identity-scoped access, governed writing with human approval, and portab

Neither MCP

stonianua

Project context your AI can query through MCP — with source evidence.

Agimem

Persistent memory for AI agents. Hosted MCP server with capsule-scoped key/value storage, tags, TTL expiration, bulk ops, and RBAC.

AOCI-CODE

aoci-spec

Local MCP server and CLI that keeps a Git-versioned, model-written index of a codebase and its database schema, so coding agents start each task with the whole system in view.

1.7K

Scento Perfume API (MCP server): free fragrance API, no key

Scento

Scento Perfume API is a free fragrance API and perfume notes database for developers and AI agents. Search 1,500+ perfumes and 400+ ingredients, compare scents, find similar perfumes, map scent families and build occasio