Yuque MCP server
io.github.yuque/yuque-mcp·v0.1.4·246 starsMCP server for Yuque — expose your knowledge base to AI assistants.
246 stars392 downloads/wk
Reviews
Write oneNobody has reviewed Yuque yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Yuque tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan31 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 75 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
How Yuque compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 80/100
- higher than 60% of 48,255 servers
- GitHub stars
- 246
- more than 95% of 28,688 servers
- Downloads a week
- 392
- more than 85% of 12,191 servers with a package
Install Yuque in Claude Code, Cursor or VS Code
Runs npx -y yuque-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add yuque-mcp -- npx -y yuque-mcp
What the publisher says
From the Yuque repository's README, as published. We do not edit it. Read it on GitHub
Yuque MCP Server
Let AI assistants read and write your Yuque (语雀) knowledge basethrough the Model Context Protocol.
[![CI][ci-image]][ci-url] [![npm version][npm-image]][npm-url] [![npm downloads][download-image]][download-url] [![License][license-image]][license-url]
Quick Start · Tools · Troubleshooting · Docs · 中文文档
Once connected, ask your assistant things like:
"Search my Yuque for everything about canary releases and give me a one-page summary."
"Turn today's meeting notes into a doc in my Tech Research book."
"Add a flowchart of this deployment pipeline to the design doc."
Quick Start
1. Get a token — create one at Yuque Developer Settings. If you use a team token bound to a Yuque space, also note the space host (e.g. https://your-space.yuque.com) — you will pass it as --host.
2. Install — one command locates the right config file for your OS and merges a yuque entry into it, without touching other servers:
npx yuque-mcp install --token=YOUR_TOKEN --client=cursorSupported clients: claude-desktop · vscode · cursor · windsurf · cline · trae · qoder · opencode. Prefer an interactive flow? Run npx yuque-mcp setup.
Claude Code
Register the server directly:
claude mcp add yuque -- npx -y yuque-mcp --token=YOUR_TOKENOther MCP clients (generic config)
Any client that supports stdio transport works — see docs/clients.md for per-client config paths.
{
"mcpServers": {
"yuque": {
"command": "npx",
"args": ["-y", "yuque-mcp"],
"env": { "YUQUE_TOKEN": "YOUR_TOKEN" }
}
}
}3. Restart your client and start asking.
Configuration
Site roots are normalized to /api/v2; when unset, the host defaults to https://www.yuque.com/api/v2.
# Team token / private deployment
npx yuque-mcp install --token=YOUR_TOKEN --client=cursor --host=https://your-space.yuque.comMigrating from an older config?
YUQUEPERSONALTOKEN, YUQUEBASEURL, and --base-url still work as legacy fallbacks. Precedence: YUQUETOKEN > YUQUEPERSONALTOKEN > --token, and YUQUEHOST > --host > YUQUEBASEURL > --base-url. New configs should use YUQUETOKEN and YUQUEHOST.
Tools (19)
Each tool maps to exactly one Yuque API route.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Yuque: common questions
- Is Yuque MCP server safe?
- Mostly: it is graded B (80/100). Read the Yuque safety report
- How do I install Yuque?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Yuque need an API key?
- Yes. The registry entry asks for
YUQUE_PERSONAL_TOKEN,YUQUE_GROUP_TOKEN,YUQUE_TOKEN. - Is Yuque maintained?
- The last commit was 112 days ago (2026-07-15). The latest release is v0.1.4.
- How does Yuque compare with other MCP servers?
- safety score 80/100 (higher than 60% of 48,255 servers); github stars 246 (more than 95% of 28,688 servers); downloads a week 392 (more than 85% of 12,191 servers with a package). Full comparison.