Yuque MCP

Let AI assistants read and write your Yuque (语雀) knowledge base through the Model Context Protocol. Its 19 documented tools cover yuque, book, doc, note. It runs locally over stdio via the published package.

People connecting documentation tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-15 · ★ 228 · #33 OF 183 MAINTAINED DOCUMENTATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Yuque MCP

before you install - you'll need

YUQUE_TOKEN

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add yuque-yuque-mcp-server -- npx -y yuque-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "yuque-yuque-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "yuque-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package yuque-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.yuque is GitHub-verified and matches the repo owner

03 · What Yuque MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can get the authenticated user for the current token, search docs or repos, with paging, list books (知识库) of a user, and get a book by ID or namespace.

The 19 tools it gives your agent

Extracted from the project's README - what yuque-mcp lets an agent do.

yuque_get_user: - Get the authenticated user for the current token
yuque_search: - Search docs or repos, with paging
yuque_list_books: - List books (知识库) of a user
yuque_get_book: - Get a book by ID or namespace
yuque_create_book: - Create a book
yuque_update_book: - Update name, slug, description, or visibility
yuque_list_docs: - List docs in a book, with paging
yuque_get_doc: - Get full content - markdown, lake, or html
yuque_create_doc: - Create a doc in a book
yuque_update_doc: - Update a doc's body or metadata
yuque_get_toc: - Get a book's table of contents
yuque_update_toc: - Append or move a single TOC node

show all 19 tools

yuque_list_notes: - List notes (小记), with paging and status filter
yuque_get_note: - Get a note with full content
yuque_create_note: - Create a note
yuque_update_note: - Update a note
yuque_get_resource: - Read a board (mindmap / flowchart / diagram) from a doc
yuque_create_resource: - Create a board in a doc
yuque_update_resource: - Update a board in a doc

Latest releases

v1.0.0 · 2026-05-27

Route markdown document reads and writes through YMD/YFM-compatible APIs. · Add board resource tools for reading, creating, and updating YFM board cards. · Support custom base URL via YUQUE_BASE_URL or --base-url for…

v0.1.13 · 2026-04-03

support Node.js v24 by fixing package.json import (#52) (#53) · add feature request issue template

v0.1.12 · 2026-03-30

sync MCP server metadata version with package version (#51)

04 · Who maintains Yuque MCP

yuque-mcp is maintained by yuque. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

repository: github.com/yuque/yuque-mcp-server
category: documentation - ranked #33 of 183 actively-maintained documentation servers as of 2026-08-25.
release cadence: 1 release in the last 90 days (latest 2026-05-27)
registry: io.github.yuque/yuque-mcp (active, first published 2026-02-27)
packages: npm:yuque-mcp

06 · Yuque MCP FAQ

Is Yuque MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-15 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can Yuque MCP do?

With this server connected, an agent can get the authenticated user for the current token, search docs or repos, with paging, list books (知识库) of a user, and get a book by ID or namespace.

How do I install Yuque MCP?

Run `npx -y yuque-mcp`. The README documents one environment variable (YUQUE_TOKEN) to set first. You can also paste the ready-made client config above.

Does Yuque MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Yuque MCP

Alternatives to Yuque MCP

Maintained documentation servers if Yuque MCP isn't the fit.

Pairs well with

Servers that cover what Yuque MCP doesn't - only shown when the pairing reason fits the companion.

More documentation MCP servers · ITASCA MCP Server · YADE MCP Server · Tela · Llmmcp

More TypeScript MCP servers · Jules Dispatch · Claudia · Stock Scanner MCP · Tunnel MCP · Chat Crystal · see all