Yuque Knowledge Base
MCP server for Yuque — expose your knowledge base to AI assistants.
What is Yuque Knowledge Base?
Yuque Knowledge Base is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for yuque — expose your knowledge base to ai assistants.
MCP server for Yuque — expose your knowledge base to AI assistants.
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for Yuque — expose your knowledge base to AI assi
Use Cases
Maintainer
Works with
Installation
NPM
npx -y yuque-mcpManual Installation
npx -y yuque-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Yuque Knowledge Base
The Yuque MCP Server exposes your Yuque knowledge base to AI assistants, enabling them to search, read, create, and update documents, books, notes, and table of contents structures through 19 dedicated tools. Yuque is a widely-used Chinese team documentation platform, and this server bridges it to MCP-compatible clients like Claude Desktop, Cursor, and VS Code so you can query your team's knowledge, draft new documents, and manage your personal notes without leaving your AI interface. Authentication uses a personal Yuque API token, and the server supports both cloud and self-hosted Yuque instances.
Prerequisites
- Node.js 18 or later installed
- A Yuque account (yuque.com or a self-hosted instance)
- A Yuque personal API token — generate one at yuque.com/settings/tokens
- An MCP-compatible client such as Claude Desktop, Cursor, or VS Code with MCP support
Generate a Yuque personal API token
Log in to Yuque, go to Settings > Tokens (yuque.com/settings/tokens), and create a new token. Give it a descriptive name like 'MCP Server' and select the required scopes (read/write for docs and books). Copy the token — it will not be shown again.
Install and configure via the quick-install command
Use the built-in install command to automatically configure yuque-mcp for your preferred client. This is the fastest setup path.
# For Cursor:
npx yuque-mcp install --token=YOUR_TOKEN --client=cursor
# For Claude Code:
claude mcp add yuque-mcp -- npx -y yuque-mcp --token=YOUR_TOKEN
# Interactive setup (prompts for token and client):
npx yuque-mcp setupOr add manually to Claude Desktop configuration
If you prefer to configure manually, open your Claude Desktop claude_desktop_config.json and add the yuque-mcp entry with the YUQUE_PERSONAL_TOKEN environment variable.
{
"mcpServers": {
"yuque": {
"command": "npx",
"args": ["-y", "yuque-mcp"],
"env": {
"YUQUE_PERSONAL_TOKEN": "your_yuque_token_here"
}
}
}
}Configure a custom Yuque instance (optional)
If you are using a self-hosted Yuque deployment, set the YUQUE_BASE_URL environment variable to point to your instance's API endpoint.
{
"mcpServers": {
"yuque": {
"command": "npx",
"args": ["-y", "yuque-mcp"],
"env": {
"YUQUE_PERSONAL_TOKEN": "your_yuque_token_here",
"YUQUE_BASE_URL": "https://your-yuque-instance.com/api/v2"
}
}
}
}Restart your MCP client and verify
Restart Claude Desktop or your chosen client. Ask it to get your Yuque user profile or search your knowledge base to confirm the 19 tools are loaded and the API token is working.
Yuque Knowledge Base Examples
Client configuration
Standard Claude Desktop configuration for yuque-mcp using the YUQUE_PERSONAL_TOKEN environment variable.
{
"mcpServers": {
"yuque": {
"command": "npx",
"args": ["-y", "yuque-mcp"],
"env": {
"YUQUE_PERSONAL_TOKEN": "your_yuque_token_here"
}
}
}
}Prompts to try
These prompts cover the main capabilities: searching, reading, creating, and managing Yuque content.
- "Search my Yuque knowledge base for documents about API design"
- "List all the books in my Yuque workspace"
- "Get the contents of the document titled 'Team Onboarding Guide'"
- "Create a new note in Yuque with the following meeting summary: [text]"
- "Update the table of contents for the Engineering book"
- "Show me all my recent Yuque notes from this week"Troubleshooting Yuque Knowledge Base
Authentication fails with 401 Unauthorized
Verify that YUQUE_PERSONAL_TOKEN is set correctly. Tokens are shown only once when created — if you lost it, delete the old token at yuque.com/settings/tokens and generate a new one. Ensure the token has the required read/write scopes for the operations you are attempting.
Search returns no results even though documents exist
The yuque_search tool searches within your accessible knowledge bases. Make sure the documents are in a space or book that your account has access to. Try listing books first with the books list tool to confirm what content is visible to your token.
Server fails to connect to a self-hosted Yuque instance
Set YUQUE_BASE_URL to the full API v2 URL of your instance (e.g., https://yuque.yourcompany.com/api/v2). The URL must not have a trailing slash. Confirm your self-hosted instance is running Yuque v2 API and that your token was generated on that instance, not on yuque.com.
Frequently Asked Questions about Yuque Knowledge Base
What is Yuque Knowledge Base?
Yuque Knowledge Base is a Model Context Protocol (MCP) server that mcp server for yuque — expose your knowledge base to ai assistants. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Yuque Knowledge Base?
Install via npm with the command: npx -y yuque-mcp. 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 Yuque Knowledge Base?
Yuque Knowledge Base works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Yuque Knowledge Base free to use?
Yes, Yuque Knowledge Base is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Yuque Knowledge Base Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to Yuque Knowledge Base? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA 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.4kAn 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.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (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.4kBuild, 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.
Set Up Yuque Knowledge Base in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Yuque Knowledge Base?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.