skills.rest
reason-machines
reason-machinesOFFICIAL
Explore all skills by this author →
Website𝕏@reasonmachinesGitHub

yuque-mcp-server

Connects AI assistants to the Yuque knowledge base API for document search and management.

7|2|Updated May 16, 2026
Search Tags:#documentation#AI assistant#MCP#search#knowledge base#document management#yuque
One-click install
npx skills add https://github.com/reason-machines/mcp-skills --skill yuque-mcp-server-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: yuque-mcp-server
Source: https://github.com/reason-machines/mcp-skills/tree/main/skills/yuque-mcp-server
Command: npx skills add https://github.com/reason-machines/mcp-skills --skill yuque-mcp-server-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yuque-mcp.

What problem does it solve? Teams using Yuque (语雀) for documentation cannot directly search, create, or update their knowledge base content from AI assistants, forcing constant context switching between tools. ## Core Features & Use Cases - Document Search & Retrieval: Search across all Yuque documents and fetch full document content through 19 MCP tools. - Content Management: Create and update documents, books (knowledge bases), notes, resources, and table of contents structures. - Flexible Deployment: Supports personal tokens, team tokens, and private Yuque deployments via custom host configuration. - Use Case: Ask your AI assistant to search your Yuque docs for "API documentation", then create a new document in your engineering-notes book summarizing the findings, all without leaving your editor. ## Quick Start Set your YUQUE_TOKEN environment variable and ask your AI assistant to search your Yuque knowledge base for a topic you need.

Frequently Asked Questions about yuque-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Yuque to Claude or Cursor with MCP?▼

Run npx yuque-mcp setup for an interactive wizard, or add a server entry to your client's MCP config with command npx, args -y yuque-mcp, and your YUQUE_TOKEN in the env block. Supported clients include claude-desktop, cursor, vscode, windsurf, and cline.

How to search Yuque documents from an AI assistant?▼

Ask the assistant to search your Yuque docs for a query, and it calls the yuque_search tool with your query string. You can optionally filter results by type such as doc, book, or user.

Does yuque-mcp support private Yuque deployments?▼

Yes, private deployments and team tokens are supported by setting the YUQUE_HOST environment variable or passing --host with your custom domain, for example https://your-space.yuque.com.

Why does yuque-mcp return a 401 Unauthorized error?▼

A 401 error means the token is invalid or expired. Regenerate a personal access token at the Yuque developer settings page and verify it has the correct permissions before updating your YUQUE_TOKEN.

What tools does the Yuque MCP server provide?▼

The server exposes 19 tools covering user info, document search, book management, document CRUD, resource uploads, table of contents editing, and personal notes. Each tool maps to a Yuque API endpoint.

Related Skills

Explore More Software Engineering Skills→
sliecsliec

style-extract

Analyzes Yuque documents to extract vocabulary, sentence, and tone patterns into a reusable writing-style profile.

Community
Intermediate
blackplume233blackplume233
12

wiki-updater

Synchronize Actant wiki content from stage and ship changes.

Community
Advanced
yuqueyuque
208

reading-digest

Extract insights, quotes, and action items from Yuque articles or pasted text into structured reading notes.

Official
Intermediate
patrykk21patrykk21

bot-jobs

Manage and synchronize scheduled jobs with the system's cron service.

Community
Intermediate