What is Yuque and why would I use this MCP server?

Yuque is a collaborative knowledge base platform. This MCP server lets you programmatically read and write Yuque content—documents, repositories, groups—directly from Claude, enabling automation of documentation workflows and content management.

How do I authenticate and set up the server?

Set the required `YUQUE_TOKEN` environment variable with your Yuque API token. Optionally configure `YUQUE_ENDPOINT` for custom API endpoints and `YUQUE_TIMEOUT_MS` for request timeouts. Install via `npx @wwwwwujl/yuque-mcp@1.1.0`.

Are write and delete operations enabled by default?

No. Write tools are disabled by default; set `YUQUE_ALLOW_WRITE=true` to enable them. Delete tools are also disabled by default; set `YUQUE_ALLOW_DELETE=true` to enable. Use namespace and group allowlists to restrict which targets can be modified.

How do I restrict write access to specific repositories or groups?

Use `YUQUE_WRITE_NAMESPACE_ALLOWLIST` (comma-separated repo namespaces) and `YUQUE_WRITE_GROUP_ALLOWLIST` (comma-separated group logins) to whitelist targets. Only operations on whitelisted namespaces and groups will be permitted.

What happens if the Yuque API times out or fails?

Configure `YUQUE_MAX_RETRIES` to control read-only retry behavior and `YUQUE_TIMEOUT_MS` to set request timeout duration. The server will respect these settings to handle transient failures gracefully.

MCP ServerSTDIOOfficialv1.1.0

Yuque MCP Server

Query and manage Yuque knowledge base content—groups, repositories, documents, and table of contents—with fine-grained read/write controls. Built for teams automating documentation workflows and content synchronization.

io.github.wwwwujl/yuque-mcp

Try MCP with AI models View source

Hosted URL

Local install

Transport

STDIO

Auth

1 required env var

What the Yuque MCP server does

How models use it and what it is built for.

Connect to Yuque

Local install — runs as a subprocess.

npx @wwwwwujl/yuque-mcp@1.1.0

Environment variables

Configuration this server reads at startup.

YUQUE_TOKENRequiredSecret
Yuque API token
YUQUE_ENDPOINT
Yuque API endpoint (optional)
YUQUE_TIMEOUT_MS
Yuque API timeout in milliseconds (optional)
YUQUE_MAX_RETRIES
Read-only retry count (optional)
YUQUE_ALLOW_WRITE
Enable write tools when true (optional, default false)
YUQUE_WRITE_NAMESPACE_ALLOWLIST
Comma-separated namespace allowlist for repo/doc/toc writes (optional)
YUQUE_WRITE_GROUP_ALLOWLIST
Comma-separated group login allowlist for group writes (optional)
YUQUE_ALLOW_DELETE
Enable delete tools when true (optional, default false)
YUQUE_DELETE_NAMESPACE_ALLOWLIST
Comma-separated delete allowlist targets (optional)
YUQUE_FILE_ROOT
Allowed root directory for file-based doc tools (optional, default current working directory)
YUQUE_FILE_MAX_BYTES
Maximum size for file-based doc tools (optional, default 1048576)
YUQUE_FILE_ALLOWED_EXTENSIONS
Comma-separated allowed extensions for file-based doc tools (optional, default .md,.markdown,.txt)

Resources

Where to find authoritative docs and source for Yuque.

Source repository

Example prompts for Yuque

Paste any of these into Agent Studio after connecting Yuque.

List all repositories in the engineering group and their document counts
Fetch the table of contents for the product docs repository
Create a new document in the allowed namespace with this markdown content
What namespaces are currently whitelisted for write operations in this server?

Yuque MCP server — FAQ

Common questions about connecting and running Yuque.

What is Yuque and why would I use this MCP server?
Yuque is a collaborative knowledge base platform. This MCP server lets you programmatically read and write Yuque content—documents, repositories, groups—directly from Claude, enabling automation of documentation workflows and content management.
How do I authenticate and set up the server?
Set the required `YUQUE_TOKEN` environment variable with your Yuque API token. Optionally configure `YUQUE_ENDPOINT` for custom API endpoints and `YUQUE_TIMEOUT_MS` for request timeouts. Install via `npx @wwwwwujl/yuque-mcp@1.1.0`.
Are write and delete operations enabled by default?
No. Write tools are disabled by default; set `YUQUE_ALLOW_WRITE=true` to enable them. Delete tools are also disabled by default; set `YUQUE_ALLOW_DELETE=true` to enable. Use namespace and group allowlists to restrict which targets can be modified.
How do I restrict write access to specific repositories or groups?
Use `YUQUE_WRITE_NAMESPACE_ALLOWLIST` (comma-separated repo namespaces) and `YUQUE_WRITE_GROUP_ALLOWLIST` (comma-separated group logins) to whitelist targets. Only operations on whitelisted namespaces and groups will be permitted.
What happens if the Yuque API times out or fails?
Configure `YUQUE_MAX_RETRIES` to control read-only retry behavior and `YUQUE_TIMEOUT_MS` to set request timeout duration. The server will respect these settings to handle transient failures gracefully.

Skip the local setup — run MCP in your browser

MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 60+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.

Open Agent Studio